aisplice

API-Referenz

Ältere APIs & Kompatibilität

#OpenAI-Kompatibilität

Jeder Pfad akzeptiert den OpenAI-Anfrage-Body — anbieterspezifische Parameter (anthropic tool_use, gemini thinking_config) werden unverändert durchgereicht.

Dieselbe Antwortstruktur wie bei OpenAI

Der Antwort-Body entspricht exakt dem von OpenAI, sodass Parser, Wiederholungslogik und Observability-Wrapper, die für OpenAI geschrieben wurden, weiter funktionieren.

Die Endpunkte auf dieser Seite sind aktiv und werden wie alle anderen abgerechnet, sind aber nicht der empfohlene Integrationsweg. Greifen Sie darauf zurück, wenn ein bestehendes Anbieter-SDK unverändert weiterlaufen muss oder Sie einen übernommenen Aufruf noch nicht migrieren können.

#Welche Schnittstelle sollten Sie nutzen?

Neue Integration

Verwenden Sie die /v1-Endpunkte im OpenAI-Format aus der API-Referenz. Ein einheitliches Vokabular für alle Fähigkeiten, und die einzige Schnittstelle, die neue Parameter erhält.

Bestehendes Anbieter-SDK

Verwenden Sie das passende Passthrough unten. Sie ändern Base URL und Schlüssel und behalten den anbietereigenen Anfrage-Body.

Übernommener Legacy-Aufruf

Er funktioniert weiter. Migrieren Sie, wenn Sie diesen Codepfad das nächste Mal anfassen — diese Routen sind eingefroren und werden nicht weiterentwickelt.

#Anbieter-natives Passthrough

Diese Routen akzeptieren den anbietereigenen Anfrage-Body und liefern das anbietereigene Antwortformat. Die Authentifizierung erfolgt weiterhin über einen einzigen Authorization: Bearer-Header mit einem Schlüssel dieser Plattform — das Authentifizierungsverfahren des Anbieters wird nicht verwendet.

Gemini nativ

Passthrough

Richten Sie das Google GenAI SDK ohne Codeänderung auf dieses Gateway aus. Pfadform und Anfrage-Body von generateContent entsprechen dem Gemini-Original.

GET/v1beta/modelsModelle im Gemini-Katalogformat auflisten.
POST/v1beta/models/*Gemini-Pfadform: /v1beta/models/{model}:{action}, z. B. :generateContent oder :streamGenerateContent.
POST/v1/models/*Dasselbe Gemini-Anfrageformat unter /v1, für Clients, die das Versionspräfix der API nicht ändern können.
POST/v1/engines/:model/embeddingsGemini-Embeddings über den älteren engines-Pfad.

Kling nativ

Passthrough

Akzeptiert den offiziellen Anfrage-Body von Kling (model_name + prompt und die anbietereigenen Felder) und gibt dessen Task-Format zurück.

POST/kling/v1/videos/text2videoEinen Kling-Text-zu-Video-Task im anbietereigenen Body-Format einreichen.
POST/kling/v1/videos/image2videoEinen Kling-Bild-zu-Video-Task einreichen.
GET/kling/v1/videos/text2video/:task_idEinen Kling-Text-zu-Video-Task abfragen.
GET/kling/v1/videos/image2video/:task_idEinen Kling-Bild-zu-Video-Task abfragen.

Jimeng nativ

Passthrough

Die offizielle Action-Query-API von Jimeng. Einreichen und Ergebnisabruf teilen sich einen Pfad und werden über den Parameter Action gewählt.

POST/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31Einen Task mit req_key und prompt im Anbieter-Body einreichen. Der abschließende Schrägstrich ist erforderlich — /jimeng leitet weiter, und bei einem 301 verwerfen die meisten HTTP-Clients den Body.
POST/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31Das Ergebnis eines eingereichten Tasks abrufen.

Suno nativ

Passthrough

Musik-Einreichung und -Abruf im Suno-Format. Für neue Integrationen besser /v1/music/generations verwenden — es liefert das Task-Format der Plattform, das auch überall sonst gilt.

POST/suno/submit/:actionaction ist music oder lyrics.
POST/suno/fetchBatch-Abruf per ID-Liste.
GET/suno/fetch/:idEinen Task abrufen.
gemini-native.sh
# Google GenAI SDK: set the API endpoint, keep everything else.
curl "https://www.aisplice.store/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello."}]}]
  }'

Passthrough-Antworten stammen vom Anbieter, nicht von uns

Statuscodes, Fehler-Bodys und Feldnamen auf diesen Routen folgen dem Upstream-Anbieter. Die Fehlerstruktur der Plattform und die dokumentierten Fehlercodes gelten nur für Ablehnungen auf Gateway-Seite, etwa bei Authentifizierung, Kontingent und Routing.

#Eingefrorene Legacy-Routen

Geroutet und abgerechnet, aber für Änderungen geschlossen: keine neuen Parameter, keine garantierten neuen Modelle und keine Kompatibilitätszusage über das hinaus, was heute funktioniert.

Legacy-Aliasse

eingefroren

Weiterhin geroutet und abgerechnet, aber eingefroren: keine neuen Parameter und keine Kompatibilitätszusagen. Migrieren Sie, wenn Sie den aufrufenden Code ohnehin anfassen.

POST/v1/completionsÄltere OpenAI-Prompt-Completion. Verwenden Sie /v1/chat/completions.
POST/v1/editsWird trotz des Namens auf das Bildbearbeitungsformat geroutet. Verwenden Sie /v1/images/edits.
POST/v1/video/generationsVideoeinreichung aus der Zeit vor dem OpenAI-Format. Verwenden Sie POST /v1/videos.
GET/v1/video/generations/:task_idVideoabfrage aus der Zeit vor dem OpenAI-Format. Verwenden Sie GET /v1/videos/{task_id}.

Midjourney-Archiv

eingefroren

Nur lesend. Kostenpflichtige Midjourney-Einreichungen wurden eingestellt; es bleibt nur die Einsicht in historische Tasks und ihre archivierten Bilder.

GET/mj/task/:id/fetchEinen archivierten Task ansehen.
GET/mj/task/:id/image-seedDen Seed eines archivierten Bilds lesen.
GET/mj/image/:idEin archiviertes Bild ausliefern.

#Wann 404 zurückkommt

Nicht unterstützte OpenAI-Schnittstellen sind gar nicht registriert. Ein 404 auf einem OpenAI-Pfad bedeutet, dass die Fähigkeit hier tatsächlich nicht angeboten wird — keine vorübergehende Lücke, und es gibt keine Route, die mit 501 etwas anderes vortäuscht.

Herausfinden, was ein Schlüssel tatsächlich erreicht

GET /v1/models listet alle Modelle auf, die dieser Schlüssel aufrufen darf. Zusammen mit einem 404 auf dem Pfad selbst können Sie „Modell nicht erlaubt“ von „Endpunkt nicht angeboten“ unterscheiden.

Immer noch nicht gelöst?

Senden Sie uns die Anfrage-ID oder die Fehlermeldung, und wir sehen uns das an.