aisplice

API リファレンス

旧 API と互換性

#OpenAI 互換性

すべてのパスは OpenAI のリクエストボディを受け付けます — ベンダー固有のパラメーター（anthropic tool_use、gemini thinking_config）はそのまま転送されます。

OpenAI と同じレスポンス形式

レスポンスボディは OpenAI と完全に一致するため、OpenAI 向けに書いたパーサー、再試行ロジック、可観測性のラッパーはそのまま動作します。

このページのエンドポイントは稼働しており他と同様に課金されますが、推奨の統合方法ではありません。既存のベンダー SDK をそのまま動かし続ける必要がある場合や、まだ移行する準備ができていない呼び出しを引き継いだ場合に使ってください。

#どのインターフェースを使うべきか

新規の統合

API リファレンスにある OpenAI 形式の /v1 エンドポイントを使ってください。すべての機能で共通の語彙を使い、新しいパラメーターが追加されるのもこのインターフェースだけです。

既存のベンダー SDK

以下の対応するパススルーを使います。変更するのはベース URL とキーだけで、ベンダー独自のリクエストボディはそのまま使えます。

引き継いだ旧来の呼び出し

引き続き動作します。そのコードパスに次に手を入れるときに移行してください — これらのルートは凍結されており、メンテナンスされません。

#ベンダーネイティブのパススルー

これらはベンダー独自のリクエストボディを受け付け、ベンダー独自のレスポンス形式で返します。認証はこれまでどおり、このプラットフォームのキーを使った Authorization: Bearer ヘッダー 1 つです — ベンダーの認証方式は使いません。

Gemini ネイティブ

パススルー

コードを変更せずに Google GenAI SDK をこのゲートウェイに向けられます。generateContent のパス形式とリクエストボディは Gemini のものをそのまま使います。

GET/v1beta/modelsGemini のカタログ形式でモデルを一覧表示します。
POST/v1beta/models/*Gemini のパス形式：/v1beta/models/{model}:{action}（例：:generateContent や :streamGenerateContent）。
POST/v1/models/*同じ Gemini のリクエスト形式を /v1 配下で提供します。API バージョンのプレフィックスを変更できないクライアント向けです。
POST/v1/engines/:model/embeddings従来の engines パス経由の Gemini 埋め込み。

Kling ネイティブ

パススルー

Kling 公式のリクエストボディ（model_name + prompt とベンダー独自のフィールド）を受け付け、Kling のタスク形式で返します。

POST/kling/v1/videos/text2videoベンダー独自のボディ形式で、Kling のテキストから動画タスクを送信します。
POST/kling/v1/videos/image2videoKling の画像から動画タスクを送信します。
GET/kling/v1/videos/text2video/:task_idKling のテキストから動画タスクをポーリングします。
GET/kling/v1/videos/image2video/:task_idKling の画像から動画タスクをポーリングします。

Jimeng ネイティブ

パススルー

Jimeng 公式の Action クエリ型 API。送信と結果取得は同じパスを共有し、Action パラメーターで切り替えます。

POST/jimeng/?Action=CVSync2AsyncSubmitTask&Version=2022-08-31ベンダーのボディで req_key と prompt を指定してタスクを送信します。末尾のスラッシュは必須です — /jimeng はリダイレクトされ、多くの HTTP クライアントは 301 でボディを破棄します。
POST/jimeng/?Action=CVSync2AsyncGetResult&Version=2022-08-31送信済みタスクの結果を取得します。

Suno ネイティブ

パススルー

Suno 形式の音楽送信と取得。新規の実装では /v1/music/generations を推奨します — 他と共通のプラットフォームのタスク形式を返します。

POST/suno/submit/:actionaction は music または lyrics です。
POST/suno/fetchID のリストで一括取得します。
GET/suno/fetch/:id1 件のタスクを取得します。
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."}]}]
  }'

パススルーのレスポンスはベンダーのもの

これらのルートのステータスコード、エラーボディ、フィールド名は上流ベンダーに従います。プラットフォームのエラー形式とドキュメント記載のエラーコードは、認証、利用枠、ルーティングなどゲートウェイ側での拒否にのみ適用されます。

#凍結された旧ルート

ルーティング・課金はされますが、変更は行われません：新しいパラメーターの追加も新しいモデルへの対応保証もなく、現在動作している範囲を超える互換性の保証もありません。

旧エイリアス

凍結

引き続きルーティング・課金されますが、凍結されています。新しいパラメーターの追加や互換性の保証はありません。呼び出し側のコードを修正する際に移行してください。

POST/v1/completionsOpenAI の旧プロンプト補完。/v1/chat/completions を使用してください。
POST/v1/edits名前に反して画像編集形式にルーティングされます。/v1/images/edits を使用してください。
POST/v1/video/generationsOpenAI 形式以前の動画送信。POST /v1/videos を使用してください。
GET/v1/video/generations/:task_idOpenAI 形式以前の動画ポーリング。GET /v1/videos/{task_id} を使用してください。

Midjourney アーカイブ

凍結

読み取り専用です。有料の Midjourney 送信は終了しており、過去のタスクとアーカイブされた画像の確認のみ可能です。

GET/mj/task/:id/fetchアーカイブされたタスクを確認します。
GET/mj/task/:id/image-seedアーカイブされた画像の seed を読み取ります。
GET/mj/image/:idアーカイブされた画像を返します。

#404 が返る場合

対応していない OpenAI のインターフェースはそもそも登録されていません。OpenAI のパスで 404 が返る場合、その機能はここでは本当に提供されていません — 一時的な欠落ではなく、対応しているふりをして 501 を返すルートもありません。

キーで実際に利用できるものを確認する

GET /v1/models は、このキーで呼び出せるすべてのモデルを一覧表示します。パス自体の 404 と組み合わせれば、「モデルが許可されていない」と「エンドポイントが提供されていない」を区別できます。

まだ解決しませんか？

リクエスト ID かエラーメッセージを送っていただければ、こちらで調査します。

前へ請求と残高次へ本番公開の前に