> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Gemini Text-zu-Bild-API
> Erzeuge Nano-Banana-Bilder über die Gemini API von BetterToken. Wähle Modell, Beschreibung, Auflösung und Seitenverhältnis und teste die Anfrage im API-Playground.
Erzeuge Bilder aus Text mit Nano Banana Pro, 2 oder 2.1.
`POST /v1beta/models/{model}:generateContent`
Textgenerierung und Bildbearbeitung nutzen denselben Endpunkt. Bei der Bearbeitung wird ein Referenzbild zur Anfrage hinzugefügt.
## Anfrage testen
Trage deinen BetterToken API Key unter **x-goog-api-key** ein, wähle **model** und ändere den Text in **contents**. Beginne mit `1K` und `1:1` und klicke auf **Send**.
Ein Klick auf **Send** sendet eine echte Generierungsanfrage, die Kosten verursachen kann. Warte auf die synchrone Antwort. Prüfe nach einem Timeout oder Verbindungsabbruch Verbrauch und Ergebnis, bevor du die Anfrage erneut sendest.
Alle drei bieten `1K`, `2K` und `4K`. Nano Banana 2 und 2.1 unterstützen 14 Seitenverhältnisse, Pro unterstützt 10. `X-BetterToken-Max-Images` begrenzt gelieferte und berechnete Bilder, garantiert aber keine Anzahl. [Seitenverhältnisse](/de/api-reference/nano-banana#aspect-ratios)
Die BetterToken API unterstützt keine Bildgenerierung mit Suche, einschließlich Google Web Search und Image Search grounding. Füge keine Suchwerkzeuge hinzu.
Für die Bildgenerierung reicht eine Textbeschreibung; ein Referenzbild ist nicht nötig. Nutze `generateContent` ohne Streaming. Files, Batch, Interactions und Streaming werden nicht unterstützt.
## Antwort lesen
Bilder stehen in `candidates[].content.parts[].inlineData`. Durchlaufe die Elemente, überspringe `thought: true`, dekodiere `data` und wähle die Dateiendung anhand von `mimeType`. Das Bild ist nicht immer das erste Element oder eine PNG-Datei.
## Weitere Anleitungen
* [Bildbearbeitung](/de/api-reference/gemini-images-edits)
* [SDK, Bildspeicherung und Folgeänderungen](/de/api-reference/nano-banana)
* [Modellübersicht](/de/model-updates/nano-banana)
* Modellkatalog
## OpenAPI
````yaml api-reference/gemini-images-generations.de.json POST /v1beta/models/{model}:generateContent
openapi: 3.1.0
info:
title: Gemini Text-zu-Bild-API
description: >-
Erzeuge Nano-Banana-Bilder über die Gemini API von BetterToken. Wähle
Modell, Beschreibung, Auflösung und Seitenverhältnis und teste die Anfrage
im API-Playground.
version: 1.0.0
servers:
- url: https://bettertoken.ai
security:
- geminiApiKey: []
paths:
/v1beta/models/{model}:generateContent:
post:
summary: Gemini Text-zu-Bild-API
description: >-
Erzeuge Bilder aus Text mit Nano Banana Pro, 2 oder 2.1. Die BetterToken
API unterstützt keine Bildgenerierung mit Suche, einschließlich Google
Web Search und Image Search grounding. Füge keine Suchwerkzeuge hinzu.
operationId: generateGeminiImage_de
parameters:
- name: model
in: path
required: true
description: BetterToken Model ID. Wähle eines der drei Nano-Banana-Modelle.
schema:
type: string
enum:
- nano-banana-pro
- nano-banana-2
- nano-banana-2.1
default: nano-banana-2.1
- name: X-BetterToken-Max-Images
in: header
description: >-
Höchstzahl gelieferter und berechneter Bilder, keine garantierte
Anzahl. Standard: 1.
schema:
type: integer
minimum: 1
maximum: 4
default: 1
requestBody:
required: true
content:
application/json:
schema:
type: object
required:
- contents
properties:
contents:
type: array
description: >-
Verlauf. Bewahre den vollständigen Modell-content und
thoughtSignature für Folgeänderungen auf.
minItems: 1
items:
type: object
required:
- parts
properties:
role:
type: string
description: >-
user für neue Anfragen; model für frühere
Modellantworten im Verlauf.
enum:
- user
- model
default: user
parts:
type: array
description: >-
Text und Bilder. Sende text und inlineData als eigene
Elemente.
minItems: 1
items:
anyOf:
- type: object
required:
- text
properties:
text:
type: string
description: Bildbeschreibung oder Bearbeitungsanweisung.
example: >-
Studioaufnahme einer blauen Keramiktasse auf
einem weißen Tisch.
additionalProperties: true
- type: object
required:
- inlineData
properties:
inlineData:
type: object
description: In base64 eingebettetes Referenzbild.
required:
- mimeType
- data
properties:
mimeType:
type: string
description: MIME-Typ des Referenzbildes.
enum:
- image/png
- image/jpeg
example: image/png
data:
type: string
description: >-
Bildbytes in base64 ohne
Data-URL-Präfix.
contentEncoding: base64
example: REPLACE_WITH_IMAGE_BASE64
additionalProperties: false
additionalProperties: true
additionalProperties: false
generationConfig:
type: object
description: Einstellungen zur Bildgenerierung.
properties:
responseModalities:
type: array
description: Fordere ausdrücklich Bildausgabe an.
items:
type: string
enum:
- IMAGE
default:
- IMAGE
candidateCount:
type: integer
enum:
- 1
default: 1
description: >-
Weglassen oder Ganzzahl 1 verwenden. Kein n auf
Wurzelebene.
imageConfig:
type: object
description: Einstellungen des Ausgabebildes.
properties:
imageSize:
type: string
description: Auflösung. Großes K verwenden.
enum:
- 1K
- 2K
- 4K
default: 1K
aspectRatio:
type: string
description: >-
Seitenverhältnis. Pro unterstützt 10; 2 und 2.1 auch
1:4, 4:1, 1:8 und 8:1.
enum:
- '1:1'
- '1:4'
- '1:8'
- '2:3'
- '3:2'
- '3:4'
- '4:1'
- '4:3'
- '4:5'
- '5:4'
- '8:1'
- '9:16'
- '16:9'
- '21:9'
default: '1:1'
additionalProperties: false
additionalProperties: false
additionalProperties: false
example:
contents:
- role: user
parts:
- text: >-
Studioaufnahme einer blauen Keramiktasse auf einem
weißen Tisch.
generationConfig:
responseModalities:
- IMAGE
candidateCount: 1
imageConfig:
imageSize: 1K
aspectRatio: '1:1'
responses:
'200':
description: Ergebnis. Prüfe finale Bildteile und finishReason.
content:
application/json:
schema:
type: object
properties:
candidates:
type: array
items:
type: object
properties:
content:
type: object
properties:
role:
type: string
parts:
type: array
items:
type: object
properties:
text:
type: string
thought:
type: boolean
thoughtSignature:
type: string
inlineData:
type: object
properties:
mimeType:
type: string
data:
type: string
contentEncoding: base64
finishReason:
type: string
promptFeedback:
type: object
additionalProperties: true
usageMetadata:
type: object
additionalProperties: true
example:
candidates:
- content:
role: model
parts:
- inlineData:
mimeType: image/png
data: BASE64_IMAGE_DATA
finishReason: STOP
'400':
description: Ungültige Parameter oder nicht unterstützte Funktion.
'401':
description: API Key fehlt oder ist ungültig.
'402':
description: Guthaben reicht nicht aus.
'429':
description: Anfragelimit oder ausgelasteter Dienst.
'500':
description: Generierungsfehler. Prüfe das Ergebnis vor einem neuen Versuch.
components:
securitySchemes:
geminiApiKey:
type: apiKey
in: header
name: x-goog-api-key
description: BetterToken API Key.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.