t2a_v2-API – GoModel übersetzt den Standard-Endpunkt /v1/audio/speech für
Sie in dieses Format.
Konfigurieren
config.yaml:
MINIMAX_BASE_URL überschreibt den Endpunkt (Standardwert
https://api.minimax.io/v1); Konten auf der chinesischen Plattform sollten
ihn auf https://api.minimaxi.com/v1 setzen.
Videoeingabe
Verwenden Sievideo_url-Inhaltsteile in Nachrichten mit MiniMax-M3 für
Videoeingaben auf /v1/chat/completions, auch bei Streaming-Requests:
Temperature
MiniMax verlangttemperature im Bereich (0.0, 1.0] und lehnt null ab.
GoModel setzt eine Temperature von null oder kleiner auf 1.0, sodass
OpenAI-Requests, die temperature: 0 festlegen, weiterhin funktionieren.
Reasoning
MiniMax-M3, MiniMax-M2.7, MiniMax-M2.7-highspeed, MiniMax-M2.5,
MiniMax-M2.5-highspeed und MiniMax-M2 schreiben ihre Gedankenkette
getrennt von der Antwort. GoModel setzt bei diesen Requests
reasoning_split: true – nur wenn der Request das Flag nicht bereits enthält,
sodass ein vom Aufrufer gesetztes reasoning_split: false maßgeblich bleibt –,
und das Thinking kommt nativ in reasoning_content an – nicht als eingebettete
<think>-Tags in content – und wird unverändert weitergegeben. Bei
gestreamten Responses sendet MiniMax zusätzlich ein Array
reasoning_details, das jedes reasoning_content-Delta dupliziert; das
Gateway entfernt dieses redundante Element aus choices[].delta. Alle anderen
MiniMax-Modelle werden unverändert durchgereicht.
Text-to-Speech
POST /v1/audio/speech wird in MiniMax’ synchrone
t2a_v2-API
übersetzt, und das hexadezimal kodierte Audio wird wieder in Binärdaten
dekodiert:
voiceerwartet eine MiniMax-Voice-ID (zum BeispielEnglish_expressive_narrator), keinen OpenAI-Stimmnamen wiealloy.response_formatunterstütztmp3(Standard),wav,flacundpcm.speedunterstützt0.5–2.0(Standard1.0).
/models-Auflistung meist nicht
zurückgegeben. Fügen Sie sie daher der konfigurierten Modellliste hinzu, damit
sie routbar sind:
Von MiniMax nicht unterstützt
Alle folgenden Fälle lieferninvalid_request_error, statt die Option
stillschweigend zu verwerfen:
- Speech-
instructions(wählen Sie eine Voice-ID, die zum gewünschten Stil passt). - Speech-Werte für
response_formataußermp3/wav/flac/pcmsowiespeedaußerhalb von0.5–2.0. - Speech-to-Text – MiniMax hat keine Transkriptions-API, daher wird
/v1/audio/transcriptionsabgelehnt. - Realtime Voice-to-Voice – das Schema von MiniMax für Echtzeit-Konversationen
ist nicht OpenAI-kompatibel und wird daher nicht unter
/v1/realtimebereitgestellt.
Image-to-Image-Generierung
Senden Sie einen Multipart-Request an/v1/images/edits mit model=image-01
oder model=image-01-live, einem prompt und hochgeladenen image-Dateien.
MiniMax verwendet die Bilder als Referenzporträts für Figuren; maskierte
Bearbeitungen führt es nicht aus. Verwenden Sie frontal aufgenommene Porträts
im Format JPEG oder PNG, jeweils kleiner als 10 MB.
Der Adapter sendet die Porträts als Data-URLs in subject_reference an
MiniMax’ Endpunkt /v1/image_generation und verwendet dabei die konfigurierte
regionale Base-URL. size=WIDTHxHEIGHT wird auf width und height
abgebildet. Eigene Abmessungen gelten nur für image-01: size, width und
height werden für image-01-live abgelehnt, dessen Größe über
aspect_ratio festgelegt wird. Die nativen Felder aspect_ratio, seed, n
und prompt_optimizer werden ebenfalls unterstützt.
response_format=b64_json wird auf MiniMax’ Format base64 abgebildet und
liefert data[].b64_json; standardmäßig wird data[].url geliefert (Links
verfallen nach 24 Stunden). Masken und nicht unterstützte Bearbeitungsfelder
führen zu einem Validierungsfehler. Native HTTP-200-Fehler werden auf dieselbe
Weise wie bei der unten beschriebenen Bildgenerierung auf den passenden
OpenAI-Fehlerstatus abgebildet.
Modellspezifische Parametergrenzen finden Sie in der
Image-to-Image-API von MiniMax.
Bildgenerierung
Verwenden Sieimage-01 oder image-01-live mit /v1/images/generations.
GoModel übersetzt Requests an MiniMax’ nativen Endpunkt /v1/image_generation
mit der konfigurierten Base-URL und liefert die generierten Bilder in data.
url; URLs verfallen nach 24 Stunden.
Verwenden Sie response_format: "b64_json" für eingebettete Bilder. Natives
base64 wird ebenfalls akzeptiert. size: "1024x1024" wird auf width und
height abgebildet; lassen Sie size weg, wenn Sie native Abmessungen oder
aspect_ratio angeben. Native Optionen wie seed und prompt_optimizer
werden durchgereicht. quality und Streaming werden nicht unterstützt.
MiniMax meldet Fehler bei Bildgenerierung, Bildbearbeitung und Speech als
HTTP 200 mit einem base_resp.status_code ungleich null. GoModel bildet diesen
Code auf den passenden OpenAI-Fehlerstatus ab – 429 für Rate- und
Nutzungslimits, 401 für Authentifizierung, 402 für Guthaben, 400 für ungültige
oder abgelehnte Eingaben, sonst 502 – und hängt MiniMax’ eigenes
base_resp.status_msg an die Fehlermeldung an, damit die Diagnose von
Upstream nicht verloren geht.
Modellspezifische Grenzen finden Sie in der
Bild-API-Referenz von MiniMax.