Bildmodelle
Bilder mit der OneMux-Bildmodell-API generieren und bearbeiten.
API-Übersicht
Bildmodelle verwenden eine separate Images-Schnittstelle. Senden Sie Anfragen zur Bildgenerierung nicht an /v1/chat/completions.
- Bildgenerierung:
POST https://api.onemux.net/v1/images/generations - Bildbearbeitung:
POST https://api.onemux.net/v1/images/edits - Authentifizierung:
Authorization: Bearer YOUR_API_KEY - Modelle: Verwenden Sie die tatsächliche Bildmodell-ID, die von der aktuellen Modellenlisten-Schnittstelle zurückgegeben wird.
Rufen Sie zunächst die aktuell verfügbaren Modelle ab:
curl https://api.onemux.net/v1/models \
-H "Authorization: Bearer $ONEMUX_API_KEY"
Ob ein Bildmodell Parameter wie Generierung, Bearbeitung, Referenzbilder, Größe, Qualität und Ausgabeformat unterstützt, hängt von der Modellliste und den tatsächlichen Fähigkeiten des Upstreams ab.
Bildgenerierung
Senden Sie eine Text-zu-Bild-Anfrage mit /v1/images/generations.
curl https://api.onemux.net/v1/images/generations \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_IMAGE_MODEL_ID",
"prompt": "一只坐在窗边的橘猫,午后自然光,写实摄影风格",
"size": "1024x1024",
"quality": "medium"
}'
Häufig verwendete Parameter:
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
model | Ja | ID eines aktuell verfügbaren Bildmodells |
prompt | Ja | Beschreibung des Bildinhalts |
size | Nein | Bildgröße; der unterstützte Bereich hängt vom Modell ab |
quality | Nein | Bildqualität; die unterstützten Werte hängen vom Modell ab |
n | Nein | Anzahl der generierten Bilder; der unterstützte Bereich hängt vom Modell ab |
response_format | Nein | b64_json oder url; nur für unterstützte Modelle verfügbar |
background | Nein | Transparenter oder undurchsichtiger Hintergrund; nur für unterstützte Modelle verfügbar |
output_format | Nein | png, jpeg, webp; nur für unterstützte Modelle verfügbar |
Verwenden Sie Parameter, die von einem Modell unterstützt werden, nicht ohne Weiteres für andere Bildmodelle. Bei Fehlern wie model_not_found, invalid_model oder nicht unterstützten Parametern überprüfen Sie zuerst die Modell-ID und die Modellfunktionen.
Bildbearbeitung
Bearbeiten Sie vorhandene Bilder mit /v1/images/edits. Gängige OpenAI-kompatible Bildmodelle verwenden multipart/form-data zum Hochladen von Bildern:
curl https://api.onemux.net/v1/images/edits \
-H "Authorization: Bearer $ONEMUX_API_KEY" \
-F "model=YOUR_IMAGE_MODEL_ID" \
-F "image[]=@input.png" \
-F "prompt=将背景改为浅蓝色,保持主体和文字不变" \
-F "size=1024x1024"
Mehrere Referenzbilder können wiederholt über image[] übergeben werden, zum Beispiel:
-F "image[]=@person.png" \
-F "image[]=@product.png"
Die Anzahl und das Format der Bilder, Masken, Referenzbild-URLs und das JSON-Bearbeitungsformat hängen vom Modell und dem Upstream-Kanal ab. Verwenden Sie diese Parameter nur, wenn das Modell sie ausdrücklich unterstützt.
Python-Aufruf
from openai import OpenAI
import os
client = OpenAI(
api_key=os.environ["ONEMUX_API_KEY"],
base_url="https://api.onemux.net/v1",
)
result = client.images.generate(
model="YOUR_IMAGE_MODEL_ID",
prompt="一张简洁的蓝色科技风产品海报",
size="1024x1024",
)
print(result.data[0].b64_json or result.data[0].url)
Für die Bildbearbeitung müssen Dateien in der Regel direkt als Multipart-Anfrage übermittelt werden. Wenn die aktuelle Version des Python-SDK die Bearbeitungsparameter des Zielmodells nicht unterstützt, verwenden Sie die obige cURL-Anfrage.
Antwort
Eine erfolgreiche Antwort enthält in der Regel ein data-Array:
{
"created": 1760000000,
"data": [
{
"b64_json": "iVBORw0KGgo..."
}
]
}
Einige Modelle geben Bild-URLs zurück, wenn response_format auf url gesetzt ist:
{
"created": 1760000000,
"data": [
{
"url": "https://example.com/generated-image.png"
}
]
}
Wenn Base64 zurückgegeben wird, speichern Sie die Datei im tatsächlichen Bildformat. Wenn eine URL zurückgegeben wird, laden Sie das Bild zeitnah herunter und speichern Sie es selbst, damit die temporäre Adresse nicht abläuft.
Abrechnung
Bildmodelle werden nicht einheitlich nach Token abgerechnet. OneMux rechnet nach den aktuell veröffentlichten Abrechnungsregeln des jeweiligen Modells ab. Dazu können gehören:
- Abrechnung pro generiertem Bild
- Abrechnung nach Bildauflösung oder Qualitätsstufe
- Abrechnung nach Eingabe- und Ausgabe-Tokens für Bilder oder nach anderem Upstream-Verbrauch
Die aktuellen Preise, Abrechnungseinheiten und unterstützten Spezifikationen finden Sie in den Angaben zum jeweiligen Modell im Modellverzeichnis. Fehlgeschlagene Anfragen verursachen normalerweise nicht die für ein erfolgreiches Ergebnis anfallenden Bildkosten. Maßgeblich sind jedoch die Anzeige auf der Seite und die Serverantwort.
Häufig gestellte Fragen
Warum kann ich keine Bilder über die Chat-Schnittstelle generieren?
Bildmodelle verwenden eine separate Images-Route. Anfragen an /v1/chat/completions oder andere nicht passende Schnittstellen können mit einem Fehler zurückgegeben werden, dass das Modell den Endpunkt nicht unterstützt, oder mit einem Parameterfehler.
Warum schlägt die Anfrage fehl, obwohl ich den Modellnamen abrufen kann?
Prüfen Sie, ob das Modell Bildgenerierung oder Bildbearbeitung erlaubt, ob der aktuelle API Key über die erforderlichen Berechtigungen verfügt, ob die Anfrageparameter im unterstützten Bereich des Modells liegen und ob der entsprechende Upstream-Kanal verfügbar ist.
Warum wird Base64 statt eines Bildlinks zurückgegeben?
Das Rückgabeformat hängt vom Modell und der Einstellung response_format ab. Bei b64_json müssen Sie die Daten im Client selbst dekodieren und speichern; bei url müssen Sie die zurückgegebene Adresse herunterladen.
Was kann ich tun, wenn die Bildgenerierung sehr lange dauert?
Anfragen mit hoher Auflösung, hoher Qualität oder komplexer Bearbeitung können mehr Zeit benötigen. Legen Sie im Client eine angemessene Zeitüberschreitung fest. Senden Sie dieselbe Anfrage nicht erneut, nur weil im Client eine Zeitüberschreitung aufgetreten ist, um doppelte Aufgaben oder Kosten zu vermeiden.
GPT Image 2.6: SVG, GIF und Komplexität
Die GPT Image 2.6-Serie bietet zusätzlich SVG-Ausgabe, animierte GIF-Ausgabe und den Parameter complexity. Diese Funktionen sind nur für Modelle und Upstream-Kanäle verfügbar, die sie unterstützen.
SVG-Ausgabe
SVG wird für die Bildgenerierung verwendet, nicht für die Bildbearbeitung. Setzen Sie beim Aufruf der Generierungsschnittstelle output_format auf svg und n auf 1. Die Bilddaten in der Antwort sind Base64-kodiert. Dekodieren Sie sie und speichern Sie sie als .svg-Datei.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一个简洁的蓝色几何图形标志",
"output_format": "svg",
"n": 1
}
Einige Upstream-Konfigurationen erfordern möglicherweise zusätzlich ein svg-Objekt, zum Beispiel svg.model. Fügen Sie es nur hinzu, wenn die Modell- oder Kanalbeschreibung dies ausdrücklich verlangt. Nicht alle Bildmodelle und Kanäle unterstützen SVG.
Animierte GIF-Ausgabe
Bei GPT Image 2.6-Modellen, die diese Funktion unterstützen, können Sie in der Bildgenerierungsschnittstelle output_format auf gif setzen. Wenn das Modell es unterstützt, können Sie mit frame_count und frame_duration_ms die Anzahl der Animationsframes und die Dauer jedes Frames festlegen. GIF ist eine Generierungsfunktion. Gehen Sie nicht davon aus, dass die Bildbearbeitungsschnittstelle ebenfalls GIF zurückgeben kann.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一只蓝色小鸟循环拍打翅膀的动画",
"output_format": "gif",
"frame_count": 6,
"frame_duration_ms": 200
}
Komplexitätsparameter
Die GPT Image 2.6-Serie unterstützt complexity: low, medium, high. Für einfache Änderungen können Sie eine niedrigere Komplexität ausprobieren. Bei textreichen Bildern oder komplexen Layouts können Sie eine höhere Komplexität ausprobieren. Dieser Parameter unterscheidet sich von quality. Bei höherer Komplexität kann die Generierung länger dauern.
{
"model": "YOUR_GPT_IMAGE_2_6_MODEL_ID",
"prompt": "一张细节丰富的城市街景编辑插画",
"complexity": "high",
"quality": "high"
}
Die oben genannten Parameter gelten nicht für alle Modelle. Wenn die Schnittstelle meldet, dass ein Parameter nicht unterstützt wird, entfernen Sie optionale Parameter oder überprüfen Sie die Fähigkeiten des ausgewählten Modells und Kanals.