From 45a762180a9de4110e5244a913e2aa082eb2a7bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=96mer=20Burak=20Da=C4=9Fl=C4=B1?= Date: Mon, 16 Mar 2026 11:09:19 +0300 Subject: [PATCH 1/3] Fix vertexapis research docs --- vertexapis-research/CHEATSHEET.md | 270 ++++-------------- vertexapis-research/QUICK_START.md | 124 ++++---- .../endpoints/translate-vertexapis-com.md | 50 ++-- 3 files changed, 145 insertions(+), 299 deletions(-) diff --git a/vertexapis-research/CHEATSHEET.md b/vertexapis-research/CHEATSHEET.md index bda054b..7fcc3ac 100644 --- a/vertexapis-research/CHEATSHEET.md +++ b/vertexapis-research/CHEATSHEET.md @@ -1,243 +1,93 @@ -# Vertex Generator - Quick Reference Cheat Sheet +# VertexAPIs Research Cheat Sheet -## Setup (One Time) +This file only references helpers that are actually present in this repo snapshot. -```bash -# Install dependencies -pip3 install requests - -# Set API key -export VERTEX_API_KEY="sk-your-api-key-here" - -# Or add to ~/.bashrc for persistence -echo 'export VERTEX_API_KEY="sk-your-key"' >> ~/.bashrc -source ~/.bashrc -``` - -## Quick Commands - -### Images (Fast - 5-15 seconds) +## Setup ```bash -# Simplest - Gemini API -python3 vertex_generator.py image "your prompt here" - -# Beta Fast (Flash model) -python3 vertex_generator.py image "your prompt" --api beta - -# Beta Quality (Pro model) -python3 vertex_generator.py image "your prompt" --api beta --model pro - -# With aspect ratio -python3 vertex_generator.py image "your prompt" --api beta --aspect-ratio 16:9 -``` - -### Videos (Slow - 30-120 seconds) - -```bash -# Basic video -python3 vertex_generator.py video "your prompt" - -# Short video (5 seconds) -python3 vertex_generator.py video "your prompt" --duration 5 - -# With audio -python3 vertex_generator.py video "your prompt" --audio - -# Fast test (720p) -python3 vertex_generator.py video "your prompt" --resolution 720p --duration 5 +export VERTEX_API_KEY="sk-your-api-key-here" ``` -## Common Use Cases - -### Social Media Images - -```bash -# Instagram post (1:1) -python3 vertex_generator.py image "product photo" --api beta --aspect-ratio 1:1 - -# Instagram story (9:16) -python3 vertex_generator.py image "portrait" --api beta --aspect-ratio 9:16 - -# YouTube thumbnail (16:9) -python3 vertex_generator.py image "thumbnail design" --api beta --aspect-ratio 16:9 +`aiplatform_runner.py` reads `VERTEX_API_KEY` by default. -# Twitter header (21:9) -python3 vertex_generator.py image "banner design" --api beta --aspect-ratio 21:9 -``` - -### Video Content +## Quick Commands ```bash -# Short clip for social (5s) -python3 vertex_generator.py video "dynamic intro" --duration 5 --audio - -# B-roll footage (8s) -python3 vertex_generator.py video "nature scene" --duration 8 --resolution 1080p - -# Quick test (720p, 3s) -python3 vertex_generator.py video "test animation" --duration 3 --resolution 720p -``` - -## API Selection Guide - -| Need | Use This Command | -|------|------------------| -| Quick image test | `--api gemini` | -| High quality image | `--api beta --model pro` | -| Fast image batch | `--api beta --model flash` | -| Any video | `--api gemini` (only option) | - -## Rate Limits - +# List registered models +python3 aiplatform_runner.py list-models + +# Text +python3 aiplatform_runner.py text \ + --model gemini-3-pro-preview \ + --prompt "Kisa bir merhaba yaz" + +# Gemini image generation +python3 aiplatform_runner.py image \ + --model gemini-3.1-flash-image-preview \ + --prompt "Single red apple icon on white background" \ + --aspect-ratio 1:1 + +# Imagen predict endpoint +python3 aiplatform_runner.py predict-image \ + --model imagen-4.0-generate-001 \ + --prompt "Single red apple icon on white background" + +# STT +python3 aiplatform_runner.py stt \ + --model gemini-2.5-pro \ + --audio ./sample.mp3 + +# Virtual try-on +python3 aiplatform_runner.py try-on \ + --person ./person.png \ + --product ./product.png ``` -gemini.vertexapis.com: 50/hour, 500/day (image + video) -beta.vertexapis.com: N/A, 3500/day (image only) -``` - -**Tips:** -- Use Beta for high-volume images (3500/day) -- Use Gemini for videos (only option, 500/day) -- Space requests by 2-5 seconds ## Output Location -```bash -# All files saved to: -~/vertex_outputs/ - -# List generated files: -ls -lth ~/vertex_outputs/ - -# Open latest image: -xdg-open ~/vertex_outputs/$(ls -t ~/vertex_outputs/*.png | head -1) - -# Open latest video: -mpv ~/vertex_outputs/$(ls -t ~/vertex_outputs/*.mp4 | head -1) -``` - -## Troubleshooting One-Liners +Default output directory: ```bash -# Check if API key is set -echo $VERTEX_API_KEY - -# Test network connectivity -curl -I https://gemini.vertexapis.com/health - -# Check rate limit status (gemini only) -curl -H "Authorization: Bearer $VERTEX_API_KEY" \ - https://gemini.vertexapis.com/key/status - -# View recent errors -python3 vertex_generator.py image "test" --api gemini 2>&1 | grep -i error - -# Check Python version -python3 --version - -# Verify requests module -python3 -c "import requests; print(requests.__version__)" +~/awesome-cortexai/generated ``` -## Batch Generation +Override it with: ```bash -# Generate multiple images -for prompt in "cat" "dog" "bird"; do - python3 vertex_generator.py image "$prompt in space" --api beta - sleep 2 -done - -# From file -while read prompt; do - python3 vertex_generator.py image "$prompt" --api beta - sleep 3 -done < prompts.txt -``` - -## Integration (Python) - -```python -from vertex_generator import VertexGenerator -import os - -gen = VertexGenerator(os.getenv("VERTEX_API_KEY")) - -# Generate image -img = gen.generate_image_gemini("a cat") - -# Generate video -vid = gen.generate_video_gemini("ocean waves", duration_seconds=5) +python3 aiplatform_runner.py image ... --out-dir /tmp/vertex-out ``` -## Performance Tips - -1. **Testing:** Use `--api beta --model flash` (fastest) -2. **Production:** Use `--api beta --model pro` (best quality) -3. **Videos:** Use `--resolution 720p --duration 5` for testing -4. **Rate limits:** Beta API has 7x higher limit than Gemini +## Translate Notes -## Common Errors & Fixes +Live and documented behavior to remember: -| Error | Fix | -|-------|-----| -| "No API key" | `export VERTEX_API_KEY="sk-..."` | -| "Video only supported on gemini" | Add `--api gemini` | -| Rate limit | Wait or use different API | -| Timeout | Video takes 30-120s, be patient | +- `/language/translate/v2` works +- `/language/translate/v2/languages` works +- plain `/v2`, `/v2/detect`, `/v2/languages` return `404` +- `v3` and `v3beta1` translation paths work -## Aliases (Optional) - -Add to `~/.bashrc`: +## Troubleshooting ```bash -# Quick aliases -alias vimg='python3 ~/awesome-cortexai/vertexapis-research/vertex_generator.py image' -alias vvid='python3 ~/awesome-cortexai/vertexapis-research/vertex_generator.py video' -alias vout='cd ~/vertex_outputs && ls -lth' - -# Usage after sourcing bashrc: -# vimg "a cat in space" -# vvid "ocean waves" --duration 5 -# vout -``` +# Check key +echo "$VERTEX_API_KEY" -## Quick Test +# Show runner help +python3 aiplatform_runner.py --help -Run all tests: -```bash -cd ~/awesome-cortexai/vertexapis-research -./test_generator.sh +# Show model registry +python3 aiplatform_runner.py list-models ``` -## File Size Estimates - -| Type | Resolution | Duration | Size | -|------|------------|----------|------| -| Image (PNG) | N/A | N/A | 1-5 MB | -| Video (720p) | 720p | 5s | 2-5 MB | -| Video (1080p) | 1080p | 5s | 5-10 MB | -| Video (1080p) | 1080p | 10s | 10-20 MB | - -## Pro Tips - -1. **Always test with 720p first** for videos -2. **Use Beta Flash for rapid iteration** on images -3. **Use Beta Pro for final images** when quality matters -4. **Add --seed** for reproducible results -5. **Space requests 2-5 seconds** to respect rate limits -6. **Check output folder** after generation: `~/vertex_outputs/` +## Repo-Contained References -## Getting Help - -```bash -# Full help -python3 vertex_generator.py --help - -# Examples -python3 vertex_generator.py --help | grep -A 20 Examples -``` +- `QUICK_START.md` +- `aiplatform_runner.py` +- `AIPLATFORM_RUNNER_TEST_RESULTS.md` +- `VERTEXAPIS_FINDINGS_2026-02-28.md` +- `endpoints/translate-vertexapis-com.md` ---- +## Notes -**Need more info?** Check `GENERATOR_README.md` for complete documentation. +- This repo snapshot does not include a committed video generator helper. +- For TTS/STT curl examples, use `../vertexapis_research/komutlar.md` and `../vertexapis_research/stt.sh`. diff --git a/vertexapis-research/QUICK_START.md b/vertexapis-research/QUICK_START.md index b8d5ae6..67141a2 100644 --- a/vertexapis-research/QUICK_START.md +++ b/vertexapis-research/QUICK_START.md @@ -1,99 +1,89 @@ -# 🚀 Quick Start Guide +# Quick Start Guide -## 1️⃣ Setup (30 seconds) +This guide only uses helpers that are present in the current repo snapshot. + +## 1. Setup ```bash -# Set API key export VERTEX_API_KEY="sk-your-api-key-here" - -# Or add to ~/.bashrc permanently -echo 'export VERTEX_API_KEY="sk-your-key"' >> ~/.bashrc -source ~/.bashrc ``` -## 2️⃣ Your First Image (10 seconds) +## 2. List Available Models ```bash -python3 vertex_media_generator.py image "a cat in space" +python3 aiplatform_runner.py list-models ``` -## 3️⃣ Your First Video (90 seconds) +## 3. Your First Text Request ```bash -python3 vertex_media_generator.py video "ocean waves" -d 5 -r 720p +python3 aiplatform_runner.py text \ + --model gemini-3-pro-preview \ + --prompt "Kisa bir merhaba yaz" ``` -## 📋 Common Commands +## 4. Your First Image ```bash -# List providers -python3 vertex_media_generator.py list - -# Image - Gemini (simple) -python3 vertex_media_generator.py image "your prompt" -p gemini - -# Image - Beta Flash (fast, 3500/day) -python3 vertex_media_generator.py image "your prompt" -p beta - -# Image - Beta Pro (quality) -python3 vertex_media_generator.py image "your prompt" -p beta --model pro - -# Video - Gemini only -python3 vertex_media_generator.py video "your prompt" -p gemini - -# Quick test -./quick_test.sh +python3 aiplatform_runner.py image \ + --model gemini-3.1-flash-image-preview \ + --prompt "a cat in space" \ + --aspect-ratio 1:1 ``` -## 📊 Provider Choice +## 5. Common Commands -| Need | Command | -|------|---------| -| Quick image test | `-p gemini` | -| High-volume images | `-p beta` (3500/day) | -| Best image quality | `-p beta --model pro` | -| Any video | `-p gemini` (only option) | +```bash +# Gemini image generation +python3 aiplatform_runner.py image \ + --model gemini-3.1-flash-image-preview \ + --prompt "studio product shot" \ + --aspect-ratio 1:1 + +# Imagen predict endpoint +python3 aiplatform_runner.py predict-image \ + --model imagen-4.0-generate-001 \ + --prompt "studio product shot" + +# STT +python3 aiplatform_runner.py stt \ + --model gemini-2.5-pro \ + --audio ./sample.mp3 + +# Virtual try-on +python3 aiplatform_runner.py try-on \ + --person ./person.png \ + --product ./product.png +``` -## 📁 Output +## 6. Output -All files: `~/vertex_outputs/` +Default output directory: ```bash -# List files -ls -lth ~/vertex_outputs/ - -# Open latest -xdg-open ~/vertex_outputs/$(ls -t ~/vertex_outputs/ | head -1) +~/awesome-cortexai/generated ``` -## 🎯 Best Practices +## 7. Translate Reminder -1. **Test with 720p first** for videos -2. **Use Beta for images** (7x higher limit) -3. **Space requests 2-5 seconds** apart -4. **Be patient with videos** (30-120s) +For `translate.vertexapis.com`: -## 🛠️ Troubleshooting - -```bash -# No API key? -export VERTEX_API_KEY="sk-your-key" +- `/language/translate/v2` works +- `/language/translate/v2/languages` works +- plain `/v2` paths return `404` +- `v3` and `v3beta1` work -# Video not working? -# Only Gemini supports video: -python3 vertex_media_generator.py video "test" -p gemini +## 8. Troubleshooting -# Want higher quality? -# Use Beta Pro model: -python3 vertex_media_generator.py image "test" -p beta --model pro +```bash +echo "$VERTEX_API_KEY" +python3 aiplatform_runner.py --help +python3 aiplatform_runner.py list-models ``` -## 📖 More Info - -- Detailed usage: `USAGE.md` -- Research report: `vertex-apis-comprehensive-report.html` -- Main README: `README.md` - ---- +## 9. More Info -**Simple. Modular. Powerful.** +- `CHEATSHEET.md` +- `AIPLATFORM_RUNNER_TEST_RESULTS.md` +- `VERTEXAPIS_FINDINGS_2026-02-28.md` +- `endpoints/translate-vertexapis-com.md` diff --git a/vertexapis-research/endpoints/translate-vertexapis-com.md b/vertexapis-research/endpoints/translate-vertexapis-com.md index 1809335..a669c03 100644 --- a/vertexapis-research/endpoints/translate-vertexapis-com.md +++ b/vertexapis-research/endpoints/translate-vertexapis-com.md @@ -6,13 +6,14 @@ API Key: `sk-your-api-key-here` ## Özet -`translate.vertexapis.com`, Google Cloud Translation API v3'ün proxy'si olarak çalışıyor. v2 endpoint'leri desteklenmiyor (404). v3 ve v3beta1 endpoint'leri tam fonksiyonel. +`translate.vertexapis.com`, birden fazla path ailesini destekliyor. Legacy Google path'i olan `/language/translate/v2` çalışıyor, düz `/v2` kısayol path'leri 404 dönüyor. `v3` ve `v3beta1` endpoint'leri de tam fonksiyonel. ## 1) API Versiyonları -| Versiyon | Durum | Not | -|----------|-------|-----| -| v2 | ❌ 404 | `/v2`, `/v2/detect`, `/v2/languages` tüm endpoint'ler 404 | +| Versiyon / Path Ailesi | Durum | Not | +|------------------------|-------|-----| +| Legacy v2 (`/language/translate/v2`) | ✅ Çalışıyor | Temel çeviri ve language list testleri başarılı | +| Plain v2 (`/v2`) | ❌ 404 | `/v2`, `/v2/detect`, `/v2/languages` 404 | | v3 | ✅ Çalışıyor | Tam fonksiyonel | | v3beta1 | ✅ Çalışıyor | v3 ile aynı davranış | @@ -298,7 +299,8 @@ Invalid JSON payload received. Unknown name "targetLanguageCode": Cannot find fi | Özellik | Google Cloud | translate.vertexapis.com | |---------|--------------|--------------------------| -| v2 API | ✅ Destekleniyor | ❌ 404 | +| Legacy v2 path (`/language/translate/v2`) | ✅ Destekleniyor | ✅ Çalışıyor | +| Plain `/v2` kısayol path'leri | N/A | ❌ 404 | | AutoML modelleri | ✅ | ❓ Test edilemedi | | Custom model training | ✅ | ❓ Test edilemedi | @@ -306,13 +308,14 @@ Invalid JSON payload received. Unknown name "targetLanguageCode": Cannot find fi ### 10.1 Çalışan ama dokümanda belirtilmeyen -1. **v3beta1 endpoint'leri:** v3 ile aynı şekilde çalışıyor -2. **global location:** Dokümanda sadece regional location'lar var, ama global da çalışıyor -3. **labels parametresi:** translateText'te metadata olarak kabul ediliyor +1. **Legacy `/language/translate/v2` path'i:** Çalışıyor, ama düz `/v2` değil +2. **v3beta1 endpoint'leri:** v3 ile aynı şekilde çalışıyor +3. **global location:** Dokümanda sadece regional location'lar var, ama global da çalışıyor +4. **labels parametresi:** translateText'te metadata olarak kabul ediliyor ### 10.2 Çalışmayan ama beklenen -1. **v2 API:** Tamamen 404 +1. **Plain `/v2` path'leri:** Tamamen 404 2. **us location:** Sadece us-central1 ve global destekleniyor 3. **Transliteration:** Sadece Japonca destekleniyor, Çince desteklenmiyor 4. **Model parametresi:** Kısa format ("nmt") çalışmıyor, full path gerekiyor ama dummy project ile test edilemedi @@ -344,9 +347,11 @@ Hata mesajları net ve açıklayıcı: | Endpoint | Method | Durum | Not | |----------|--------|-------|-----| -| `/v2` | POST | ❌ 404 | v2 desteklenmiyor | -| `/v2/detect` | POST | ❌ 404 | v2 desteklenmiyor | -| `/v2/languages` | GET | ❌ 404 | v2 desteklenmiyor | +| `/language/translate/v2` | POST | ✅ | Legacy Google path'i çalışıyor | +| `/language/translate/v2/languages` | GET | ✅ | Legacy Google path'i çalışıyor | +| `/v2` | POST | ❌ 404 | Plain root v2 path'i desteklenmiyor | +| `/v2/detect` | POST | ❌ 404 | Plain root v2 path'i desteklenmiyor | +| `/v2/languages` | GET | ❌ 404 | Plain root v2 path'i desteklenmiyor | | `/v3/.../translateText` | POST | ✅ | Tam fonksiyonel | | `/v3/.../detectLanguage` | POST | ✅ | Tam fonksiyonel | | `/v3/.../supportedLanguages` | GET | ✅ | 230+ dil | @@ -364,20 +369,21 @@ Hata mesajları net ve açıklayıcı: ### 13.1 Genel Değerlendirme -`translate.vertexapis.com`, Google Cloud Translation API v3'ün tam fonksiyonel bir proxy'si. Core translation özellikleri (translateText, detectLanguage, supportedLanguages) mükemmel çalışıyor. +`translate.vertexapis.com`, hem legacy `/language/translate/v2` hem de modern `v3`/`v3beta1` path ailelerini sunuyor. Plain `/v2` kısayol path'leri desteklenmiyor. Core translation özellikleri (translateText, detectLanguage, supportedLanguages) güçlü şekilde çalışıyor. ### 13.2 Güçlü Yönler -1. ✅ translateText tam fonksiyonel (batch, HTML, multi-language) -2. ✅ detectLanguage yüksek doğrulukla çalışıyor -3. ✅ 230+ dil desteği -4. ✅ HTML tag koruması mükemmel -5. ✅ Batch operations endpoint'leri çalışıyor -6. ✅ v3beta1 desteği var +1. ✅ Legacy `/language/translate/v2` path'i çalışıyor +2. ✅ translateText tam fonksiyonel (batch, HTML, multi-language) +3. ✅ detectLanguage yüksek doğrulukla çalışıyor +4. ✅ 230+ dil desteği +5. ✅ HTML tag koruması mükemmel +6. ✅ Batch operations endpoint'leri çalışıyor +7. ✅ v3beta1 desteği var ### 13.3 Zayıf Yönler / Kısıtlamalar -1. ❌ v2 API tamamen desteklenmiyor +1. ❌ Plain `/v2` path'leri desteklenmiyor 2. ⚠️ romanizeText sadece Japonca için çalışıyor 3. ⚠️ translateDocument test edilemedi (gerçek dosya gerekiyor) 4. ⚠️ Model parametresi kısa format desteklemiyor @@ -393,7 +399,7 @@ Hata mesajları net ve açıklayıcı: - Japonca romanizasyon **Dikkat edilmesi gerekenler:** -- v2 API kullanmayın (404) +- Legacy gerekiyorsa `/language/translate/v2` kullanın; düz `/v2` path'lerini kullanmayın - Location olarak `us-central1` veya `global` kullanın - Transliteration için sadece Japonca güvenilir - Model parametresi için full path kullanın @@ -402,7 +408,7 @@ Hata mesajları net ve açıklayıcı: ### 13.5 Google Cloud Translation API ile Karşılaştırma **Parity:** %95+ -**Eksik özellikler:** v2 API, sınırlı romanization +**Eksik özellikler:** plain `/v2` kısayol path'leri, sınırlı romanization **Ek özellikler:** Yok **Performans:** Eşdeğer From b8721c05c03e480c9a7178ecd53524d7408ffefd Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=96mer=20Burak=20Da=C4=9Fl=C4=B1?= Date: Mon, 16 Mar 2026 15:07:27 +0300 Subject: [PATCH 2/3] Address PR review feedback --- vertexapis-research/CHEATSHEET.md | 41 ++++++++++++++----- vertexapis-research/QUICK_START.md | 35 ++++++++++------ .../endpoints/translate-vertexapis-com.md | 25 +++++++---- 3 files changed, 69 insertions(+), 32 deletions(-) diff --git a/vertexapis-research/CHEATSHEET.md b/vertexapis-research/CHEATSHEET.md index 7fcc3ac..17d61d1 100644 --- a/vertexapis-research/CHEATSHEET.md +++ b/vertexapis-research/CHEATSHEET.md @@ -8,41 +8,58 @@ This file only references helpers that are actually present in this repo snapsho export VERTEX_API_KEY="sk-your-api-key-here" ``` -`aiplatform_runner.py` reads `VERTEX_API_KEY` by default. +Run the commands below from the repository root. The committed helper lives at `vertexapis-research/aiplatform_runner.py`. + +`vertexapis-research/aiplatform_runner.py` reads `VERTEX_API_KEY` by default. + +## Provider Notes + +- `aiplatform.vertexapis.com` is the main repo-contained path for text, image, STT, and try-on examples. +- `beta.vertexapis.com` is still the higher-volume image provider in the research notes. +- `gemini.vertexapis.com` is still mentioned in older notes for image/video workflows, but the generator helper that used it is not committed in this snapshot. ## Quick Commands ```bash # List registered models -python3 aiplatform_runner.py list-models +python3 vertexapis-research/aiplatform_runner.py list-models # Text -python3 aiplatform_runner.py text \ +python3 vertexapis-research/aiplatform_runner.py text \ --model gemini-3-pro-preview \ --prompt "Kisa bir merhaba yaz" # Gemini image generation -python3 aiplatform_runner.py image \ +python3 vertexapis-research/aiplatform_runner.py image \ --model gemini-3.1-flash-image-preview \ --prompt "Single red apple icon on white background" \ --aspect-ratio 1:1 # Imagen predict endpoint -python3 aiplatform_runner.py predict-image \ +python3 vertexapis-research/aiplatform_runner.py predict-image \ --model imagen-4.0-generate-001 \ --prompt "Single red apple icon on white background" # STT -python3 aiplatform_runner.py stt \ +python3 vertexapis-research/aiplatform_runner.py stt \ --model gemini-2.5-pro \ --audio ./sample.mp3 # Virtual try-on -python3 aiplatform_runner.py try-on \ +python3 vertexapis-research/aiplatform_runner.py try-on \ --person ./person.png \ --product ./product.png ``` +## Rate Limits + +These limits come from the existing research notes in this repo: + +```text +gemini.vertexapis.com: 50/hour, 500/day (image + video) +beta.vertexapis.com: N/A, 3500/day (image only) +``` + ## Output Location Default output directory: @@ -54,7 +71,11 @@ Default output directory: Override it with: ```bash -python3 aiplatform_runner.py image ... --out-dir /tmp/vertex-out +python3 vertexapis-research/aiplatform_runner.py image \ + --model gemini-3.1-flash-image-preview \ + --prompt "Single red apple icon on white background" \ + --aspect-ratio 1:1 \ + --out-dir /tmp/vertex-out ``` ## Translate Notes @@ -73,10 +94,10 @@ Live and documented behavior to remember: echo "$VERTEX_API_KEY" # Show runner help -python3 aiplatform_runner.py --help +python3 vertexapis-research/aiplatform_runner.py --help # Show model registry -python3 aiplatform_runner.py list-models +python3 vertexapis-research/aiplatform_runner.py list-models ``` ## Repo-Contained References diff --git a/vertexapis-research/QUICK_START.md b/vertexapis-research/QUICK_START.md index 67141a2..b3c6697 100644 --- a/vertexapis-research/QUICK_START.md +++ b/vertexapis-research/QUICK_START.md @@ -2,6 +2,8 @@ This guide only uses helpers that are present in the current repo snapshot. +Run the commands below from the repository root. The committed helper lives at `vertexapis-research/aiplatform_runner.py`. + ## 1. Setup ```bash @@ -11,13 +13,13 @@ export VERTEX_API_KEY="sk-your-api-key-here" ## 2. List Available Models ```bash -python3 aiplatform_runner.py list-models +python3 vertexapis-research/aiplatform_runner.py list-models ``` ## 3. Your First Text Request ```bash -python3 aiplatform_runner.py text \ +python3 vertexapis-research/aiplatform_runner.py text \ --model gemini-3-pro-preview \ --prompt "Kisa bir merhaba yaz" ``` @@ -25,7 +27,7 @@ python3 aiplatform_runner.py text \ ## 4. Your First Image ```bash -python3 aiplatform_runner.py image \ +python3 vertexapis-research/aiplatform_runner.py image \ --model gemini-3.1-flash-image-preview \ --prompt "a cat in space" \ --aspect-ratio 1:1 @@ -35,28 +37,34 @@ python3 aiplatform_runner.py image \ ```bash # Gemini image generation -python3 aiplatform_runner.py image \ +python3 vertexapis-research/aiplatform_runner.py image \ --model gemini-3.1-flash-image-preview \ --prompt "studio product shot" \ --aspect-ratio 1:1 # Imagen predict endpoint -python3 aiplatform_runner.py predict-image \ +python3 vertexapis-research/aiplatform_runner.py predict-image \ --model imagen-4.0-generate-001 \ --prompt "studio product shot" # STT -python3 aiplatform_runner.py stt \ +python3 vertexapis-research/aiplatform_runner.py stt \ --model gemini-2.5-pro \ --audio ./sample.mp3 # Virtual try-on -python3 aiplatform_runner.py try-on \ +python3 vertexapis-research/aiplatform_runner.py try-on \ --person ./person.png \ --product ./product.png ``` -## 6. Output +## 6. Provider Notes + +- `aiplatform.vertexapis.com` is the main repo-contained workflow here. +- `beta.vertexapis.com` remains the higher-volume image provider in the research notes. +- The older generator-based `gemini.vertexapis.com` workflow is not included as a committed helper in this repo snapshot. + +## 7. Output Default output directory: @@ -64,24 +72,25 @@ Default output directory: ~/awesome-cortexai/generated ``` -## 7. Translate Reminder +## 8. Translate Reminder For `translate.vertexapis.com`: - `/language/translate/v2` works +- `/language/translate/v2/detect` works - `/language/translate/v2/languages` works - plain `/v2` paths return `404` - `v3` and `v3beta1` work -## 8. Troubleshooting +## 9. Troubleshooting ```bash echo "$VERTEX_API_KEY" -python3 aiplatform_runner.py --help -python3 aiplatform_runner.py list-models +python3 vertexapis-research/aiplatform_runner.py --help +python3 vertexapis-research/aiplatform_runner.py list-models ``` -## 9. More Info +## 10. More Info - `CHEATSHEET.md` - `AIPLATFORM_RUNNER_TEST_RESULTS.md` diff --git a/vertexapis-research/endpoints/translate-vertexapis-com.md b/vertexapis-research/endpoints/translate-vertexapis-com.md index a669c03..2729a3f 100644 --- a/vertexapis-research/endpoints/translate-vertexapis-com.md +++ b/vertexapis-research/endpoints/translate-vertexapis-com.md @@ -1,18 +1,20 @@ # translate.vertexapis.com Derin Test Raporu -Tarih: 2026-03-01 +Orijinal derin test tarihi: 2026-03-01 Test Edilen Domain: `translate.vertexapis.com` API Key: `sk-your-api-key-here` +Guncelleme notu: 2026-03-16 tarihinde path ailesi ayrimi tekrar canli dogrulandi. Sonuc: legacy Google path'leri `/language/translate/v2`, `/language/translate/v2/detect`, `/language/translate/v2/languages` calisiyor; plain root `/v2`, `/v2/detect`, `/v2/languages` ise 404 donuyor. + ## Özet -`translate.vertexapis.com`, birden fazla path ailesini destekliyor. Legacy Google path'i olan `/language/translate/v2` çalışıyor, düz `/v2` kısayol path'leri 404 dönüyor. `v3` ve `v3beta1` endpoint'leri de tam fonksiyonel. +`translate.vertexapis.com`, birden fazla path ailesini destekliyor. Legacy Google path'i olan `/language/translate/v2` calisiyor, duz `/v2` kisayol path'leri 404 donuyor. `v3` ve `v3beta1` endpoint'leri de tam fonksiyonel. ## 1) API Versiyonları | Versiyon / Path Ailesi | Durum | Not | |------------------------|-------|-----| -| Legacy v2 (`/language/translate/v2`) | ✅ Çalışıyor | Temel çeviri ve language list testleri başarılı | +| Legacy v2 (`/language/translate/v2`) | ✅ Çalışıyor | Translate, detect ve languages canlı re-check ile doğrulandı | | Plain v2 (`/v2`) | ❌ 404 | `/v2`, `/v2/detect`, `/v2/languages` 404 | | v3 | ✅ Çalışıyor | Tam fonksiyonel | | v3beta1 | ✅ Çalışıyor | v3 ile aynı davranış | @@ -286,6 +288,9 @@ Invalid JSON payload received. Unknown name "targetLanguageCode": Cannot find fi | Google Cloud API | translate.vertexapis.com | Durum | |------------------|--------------------------|-------| +| `translation.googleapis.com/language/translate/v2` | `translate.vertexapis.com/language/translate/v2` | ✅ Legacy path calisiyor | +| `translation.googleapis.com/language/translate/v2/detect` | `translate.vertexapis.com/language/translate/v2/detect` | ✅ Legacy path calisiyor | +| `translation.googleapis.com/language/translate/v2/languages` | `translate.vertexapis.com/language/translate/v2/languages` | ✅ Legacy path calisiyor | | `translation.googleapis.com/v3/.../translateText` | `translate.vertexapis.com/v3/.../translateText` | ✅ Birebir | | `translation.googleapis.com/v3/.../detectLanguage` | `translate.vertexapis.com/v3/.../detectLanguage` | ✅ Birebir | | `translation.googleapis.com/v3/.../supportedLanguages` | `translate.vertexapis.com/v3/.../supportedLanguages` | ✅ Birebir | @@ -299,7 +304,7 @@ Invalid JSON payload received. Unknown name "targetLanguageCode": Cannot find fi | Özellik | Google Cloud | translate.vertexapis.com | |---------|--------------|--------------------------| -| Legacy v2 path (`/language/translate/v2`) | ✅ Destekleniyor | ✅ Çalışıyor | +| Legacy v2 path (`/language/translate/v2*`) | ✅ Destekleniyor | ✅ Çalışıyor | | Plain `/v2` kısayol path'leri | N/A | ❌ 404 | | AutoML modelleri | ✅ | ❓ Test edilemedi | | Custom model training | ✅ | ❓ Test edilemedi | @@ -308,7 +313,7 @@ Invalid JSON payload received. Unknown name "targetLanguageCode": Cannot find fi ### 10.1 Çalışan ama dokümanda belirtilmeyen -1. **Legacy `/language/translate/v2` path'i:** Çalışıyor, ama düz `/v2` değil +1. **Legacy `/language/translate/v2*` path'i:** Calisiyor, ama duz `/v2` degil 2. **v3beta1 endpoint'leri:** v3 ile aynı şekilde çalışıyor 3. **global location:** Dokümanda sadece regional location'lar var, ama global da çalışıyor 4. **labels parametresi:** translateText'te metadata olarak kabul ediliyor @@ -348,6 +353,7 @@ Hata mesajları net ve açıklayıcı: | Endpoint | Method | Durum | Not | |----------|--------|-------|-----| | `/language/translate/v2` | POST | ✅ | Legacy Google path'i çalışıyor | +| `/language/translate/v2/detect` | POST | ✅ | Legacy Google path'i çalışıyor | | `/language/translate/v2/languages` | GET | ✅ | Legacy Google path'i çalışıyor | | `/v2` | POST | ❌ 404 | Plain root v2 path'i desteklenmiyor | | `/v2/detect` | POST | ❌ 404 | Plain root v2 path'i desteklenmiyor | @@ -369,11 +375,11 @@ Hata mesajları net ve açıklayıcı: ### 13.1 Genel Değerlendirme -`translate.vertexapis.com`, hem legacy `/language/translate/v2` hem de modern `v3`/`v3beta1` path ailelerini sunuyor. Plain `/v2` kısayol path'leri desteklenmiyor. Core translation özellikleri (translateText, detectLanguage, supportedLanguages) güçlü şekilde çalışıyor. +`translate.vertexapis.com`, hem legacy `/language/translate/v2*` hem de modern `v3`/`v3beta1` path ailelerini sunuyor. Plain `/v2` kısayol path'leri desteklenmiyor. Core translation özellikleri (translateText, detectLanguage, supportedLanguages) guclu sekilde calisiyor. ### 13.2 Güçlü Yönler -1. ✅ Legacy `/language/translate/v2` path'i çalışıyor +1. ✅ Legacy `/language/translate/v2*` path'leri calisiyor 2. ✅ translateText tam fonksiyonel (batch, HTML, multi-language) 3. ✅ detectLanguage yüksek doğrulukla çalışıyor 4. ✅ 230+ dil desteği @@ -399,7 +405,7 @@ Hata mesajları net ve açıklayıcı: - Japonca romanizasyon **Dikkat edilmesi gerekenler:** -- Legacy gerekiyorsa `/language/translate/v2` kullanın; düz `/v2` path'lerini kullanmayın +- Legacy gerekiyorsa `/language/translate/v2*` kullanin; duz `/v2` path'lerini kullanmayin - Location olarak `us-central1` veya `global` kullanın - Transliteration için sadece Japonca güvenilir - Model parametresi için full path kullanın @@ -414,8 +420,9 @@ Hata mesajları net ve açıklayıcı: --- -**Test Tarihi:** 2026-03-01 +**Orijinal Test Tarihi:** 2026-03-01 **Test Eden:** OpenCode +**Orijinal kampanya ozet sayilari:** Bu rakamlar 2026-03-01 derin test snapshot'ina aittir; 2026-03-16 legacy/plain v2 path re-check'i bu toplamlara dahil degildir. **Toplam Test Sayısı:** 25+ **Başarılı Test:** 18 **Başarısız Test:** 4 From 2fe30348819f4abbe4adaa598bc8304ac42196ee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=C3=96mer=20Burak=20Da=C4=9Fl=C4=B1?= Date: Mon, 16 Mar 2026 15:10:06 +0300 Subject: [PATCH 3/3] Sync legacy detect path notes --- vertexapis-research/CHEATSHEET.md | 1 + 1 file changed, 1 insertion(+) diff --git a/vertexapis-research/CHEATSHEET.md b/vertexapis-research/CHEATSHEET.md index 17d61d1..c7eee97 100644 --- a/vertexapis-research/CHEATSHEET.md +++ b/vertexapis-research/CHEATSHEET.md @@ -83,6 +83,7 @@ python3 vertexapis-research/aiplatform_runner.py image \ Live and documented behavior to remember: - `/language/translate/v2` works +- `/language/translate/v2/detect` works - `/language/translate/v2/languages` works - plain `/v2`, `/v2/detect`, `/v2/languages` return `404` - `v3` and `v3beta1` translation paths work