エンドポイント規約
Starmodel は単一の OpenAI 互換ゲートウェイを公開します。すべてのリクエストは同じ base URL に送られ、パスが機能を、model フィールドがモデルを選びます。
Base URL
https://api.starmodel.ai/v1これはあなたのゲートウェイドメインです。以下のエンドポイントパスを続けて指定し、各リクエストは Authorization: Bearer $API_KEY で認証してください。
エンドポイント一覧
| 機能 | メソッド | パス |
|---|---|---|
| チャット補完 | POST | /v1/chat/completions |
| Anthropic messages | POST | /v1/messages |
| Responses API | POST | /v1/responses |
| 画像生成 | POST | /v1/images/generations |
| 画像編集 | POST | /v1/images/edits |
| 動画生成 | POST | /v1/videos/generations |
| 音声合成 | POST | /v1/audio/speech |
| モデル一覧 | GET | /v1/models |
同期と非同期
Chat・messages・responses は 1 回の HTTP リクエストで応答します。stream: true を指定すると Server-Sent Events（text/event-stream）で返り、data: [DONE] で終了します。
画像・動画・音声 の生成は上流では長時間タスクですが、ゲートウェイが代わりにタスクをポーリングし、統一された同期 JSON 結果を返します——task id をポーリングする必要はありません。動画ではクライアントのタイムアウトを長めに設定してください。レート制限されたリクエストは Retry-After ヘッダー付きの HTTP 429 を返します。
直接連携からの移行
エンドポイントは OpenAI 互換なので、多くの場合は base_url を変えるだけです：
- client = OpenAI(api_key=OPENAI_KEY)+ client = OpenAI(+ api_key=SEEAI_KEY,+ base_url="https://api.starmodel.ai/v1",+ )Anthropic SDK を使う場合は、その base_url を同じゲートウェイに向け、/v1/messages を呼び出してください。