ViNano AI API
Leistungsstarke AI-Bildgenerierungs-REST-API, integrieren Sie sie mit nur wenigen Codezeilen in Ihre App
API-Nutzungsanforderungen
- Abonnement des Advanced-Plans erforderlich
- Jahresabonnenten: 200 Anfragen/Minute Rate-Limit
- Monatsabonnenten: 20 Anfragen/Minute Rate-Limit
Benötigen Sie erweiterte API-Funktionen?
Wenn Sie höhere Rate-Limits, Enterprise-Support oder benutzerdefinierte Funktionen benötigen, senden Sie bitte eine E-Mail an:
[email protected]Skills & Integrationsanleitungen
Entdecken Sie API-Integrationsanleitungen, Codebeispiele und Best Practices für ViNano AI API
Auf GitHub ansehenDarauf kannst du dich freuen
Für Entwickler entwickelt, die Bildverarbeitung in großem Maßstab benötigen
Verarbeitungszeit
Die Verarbeitungszeit variiert je nach gewähltem Modell, Einstellungen und Dienstauslastung.
Einfache Integration
RESTful API mit ausführlicher Dokumentation und SDKs in mehreren Sprachen
Flexible Preise
Zahle nur, was du nutzt – transparent und entwicklerfreundlich
API-Aufrufanweisungen
Erfahren Sie, wie Sie die ViNano AI API zur Bildgenerierung verwenden
Schnellstart
Integrieren Sie AI-Bildgenerierung in nur wenigen Codezeilen
POST https://vinano.ai/api/v2/images/generatecurl -X POST https://vinano.ai/api/v2/images/generate \
-H "Authorization: Bearer YOUR_TOKEN" \
-F "prompt=a beautiful sunset over the ocean" \
-F "model=gemini-2.5-flash-image-preview" \
-F "aspectRatio=16:9" \
-F "googleSearch=false" \
-F "mode=txt2img"Anfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| prompt | string | No* | Bildgenerierungs-Prompt (max. 2000 Zeichen) |
| image | File / File[] | No* | Hochgeladene Bilddatei(en) (mehrere unterstützt) |
| imageUrl | string / string[] | No* | Existing image URL(s) (supports multiple URLs) |
| model | string | No | AI-Modell, unterstützt gemini-2.5-flash-image-preview, sora_image |
| aspectRatio | string | No | Seitenverhältnis, z.B. 1:1, 16:9, 9:16 |
| mode | string | No | Optionaler Generierungsmodus, z.B. photo_restoration (alte Fotos), figure, meme usw. Alle Modi anzeigen |
| hdPro | boolean | No | Ob HD-Modus verwendet werden soll (verbraucht 30 Credits, Normalmodus 10 Credits) |
| img_size | string | No | Bildgröße: 1k, 2k, 4k (nur gemini-3-pro-image-preview Modell, Credits: 1k=30, 2k=50, 4k=80) |
| googleSearch | boolean | No | Google-Suche aktivieren (nur für gemini-3.1-pro-image-preview Modell unterstützt, Standard false) |
* Entweder prompt oder image muss angegeben werden
Unterstützte Modelle
- gemini-2.5-flash-image-preview- Nano Banana (Standard)
- gemini-3.1-pro-image-preview- Nano Banana 2 (unterstützt erweiterte Seitenverhältnisse 4:1, 1:4, 8:1, 1:8)
- nano-banana-2.1Nano Banana 2.1 (1K: 30, 2K: 50, 4K: 70 Credits/Bild; Mitgliedschaft erforderlich; nicht zahlende Konten: +10)
- gemini-3-pro-image-preview- Nano Banana Pro
- sora_image- GPT-Image 2
- Seedance-5.0- Seedance 5.0 (nur 2K/3K, Text→Bild und Bild→Bild, mit Websuche)
- Z-Image- ViNano Basic (Z-Image, nur Text→Bild)
Antwortformat
Erfolgreiche Antwort (200)
{
"status": 200,
"images": ["https://example.com/generated-image.jpg"],
"imageDetails": [{
"width": 1024,
"height": 1024,
"filesize": 524288
}],
"uuid": "550e8400-e29b-41d4-a716-446655440000",
"prompt": "a beautiful sunset",
"model": "gemini-2.5-flash-image-preview",
"credits": {
"cost": 10
}
}⚡ Asynchrone Bildgenerierungs-API
POST https://vinano.ai/api/v1/images/asyncGET https://vinano.ai/api/v1/images/task-status?task_id={task_id}# Step 1: Submit async task (same parameters as sync API)
curl -X POST "https://vinano.ai/api/v1/images/async" \
-H "Authorization: Bearer YOUR_TOKEN" \
-F "prompt=a beautiful sunset" \
-F "model=gemini-2.5-flash-image-preview"
# Response (202):
# {
# "status": 202,
# "task_id": "550e8400-e29b-41d4-a716-446655440000",
# "message": "Task submitted. Use GET /api/v1/images/task-status?task_id={task_id} to poll for results.",
# "model": "gemini-2.5-flash-image-preview",
# "credits": { "cost": 10 }
# }
# Step 2: Poll task status (repeat every 3-5s until status=200)
curl -X GET "https://vinano.ai/api/v1/images/task-status?task_id=550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer YOUR_TOKEN"
# Response when completed:
# {
# "status": 200,
# "images": ["https://example.com/generated-image.jpg"],
# "imageDetails": [{
# "width": 1024,
# "height": 1024,
# "filesize": 524288
# }],
# "uuid": "550e8400-e29b-41d4-a716-446655440000",
# "prompt": "a beautiful sunset",
# "model": "gemini-2.5-flash-image-preview",
# "credits": {
# "cost": 10
# }
# }Fehlercode-Erklärung
| Statuscode | Beschreibung |
|---|---|
| 400 | Erforderliche Parameter fehlen oder Parametervalidierung fehlgeschlagen |
| 401 | API-Token ungültig, fehlend oder fehlerhaft |
| 403 | Konto deaktiviert, nicht für Advanced-Plan abonniert oder keine API-Berechtigung |
| 413 | Dateigröße überschreitet Limit (100MB) |
| 429 | Rate-Limit überschritten (pro Minute Limit überschritten) |
| 495 | Unzureichende Credits |
| 500 | Interner Serverfehler oder Bildgenerierung fehlgeschlagen |
Best Practices
API-Token sicher aufbewahren
Teilen Sie Ihr API-Token nicht mit anderen und veröffentlichen Sie es nicht in Code-Repositories
Fehlerbehandlung implementieren
Behandeln Sie alle möglichen Fehlercodes, insbesondere 429 (Rate-Limit) und 495 (unzureichende Credits)
Rate-Limit-Header überwachen
Überprüfen Sie X-RateLimit-Remaining in Antwortheadern, um verbleibendes Kontingent zu verstehen
Wiederholungsmechanismus implementieren
Für 429 Fehler, implementieren Sie exponentielles Backoff-Retry basierend auf Retry-After-Header
Prompts optimieren
Klare, spezifische Prompts liefern bessere Generierungsergebnisse
Bilder komprimieren
Komprimierung von Bildern vor dem Hochladen verbessert Übertragungsgeschwindigkeit und spart Bandbreite
API-Rate-Limit
API-Aufrufe sind durch Rate-Limiting geschützt, Limits variieren je nach Abonnementplan:
💡Antwortheader enthalten X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset Informationen