API REFERENCE
Synthia API
OpenAI Chat Completions 互換の API です。既存の OpenAI SDK の base_url を差し替えるだけで利用できます。キーの発行・残高・利用状況は 開発者コンソール で確認できます。
ベース URL:
https://platform.ai-sns.io/api/v1認証
すべてのリクエストに Authorization: Bearer sk-syn-… ヘッダーが必要です。キーはサーバー側でのみ使い、ブラウザやアプリに埋め込まないでください。Cookie による認証は受け付けません。
Authorization: Bearer $SYNTHIA_API_KEYエンドポイント
| メソッド | パス | 説明 |
|---|---|---|
| POST | /api/v1/chat/completions | チャット補完(ストリーミング対応) |
| GET | /api/v1/models | 利用可能なモデルと料金 |
Chat Completions
リクエストボディは OpenAI と同じ形式です(model、messages 必須。max_tokens、temperature などはそのまま上流に渡されます)。
curl https://platform.ai-sns.io/api/v1/chat/completions \
-H "Authorization: Bearer $SYNTHIA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"synthia-max","messages":[{"role":"user","content":"こんにちは"}]}'レスポンス:
{
"id": "chatcmpl-…",
"object": "chat.completion",
"model": "synthia-max",
"choices": [
{ "index": 0, "message": { "role": "assistant", "content": "…" }, "finish_reason": "stop" }
],
"usage": { "prompt_tokens": 12, "completion_tokens": 34, "total_tokens": 46 }
}ストリーミング
"stream": true で Server-Sent Events を返します。stream_options.include_usage を指定すると、最後のチャンクに usage が含まれます。課金は最後に確定したトークン数で行われます(上流が usage を返さない場合は文字数から推定)。
{
"model": "synthia-max",
"messages": [{"role": "user", "content": "要約して"}],
"stream": true,
"stream_options": { "include_usage": true }
}
data: {"choices":[{"delta":{"content":"…"}}]}
data: {"choices":[],"usage":{"prompt_tokens":12,"completion_tokens":34,"total_tokens":46}}
data: [DONE]モデル一覧
curl https://platform.ai-sns.io/api/v1/models -H "Authorization: Bearer $SYNTHIA_API_KEY"
{
"object": "list",
"data": [
{ "id": "synthia-max", "object": "model", "context_window": 200000,
"pricing": { "currency": "USD", "unit": "per_million_tokens", "input": "4", "output": "20" } }
]
}エラー
エラーは OpenAI 形式 {"error":{"message","type","code"}} で返ります。
| HTTP | code | 意味・対処 |
|---|---|---|
| 401 | invalid_api_key | キーがない・誤り・無効化済み。 |
| 402 | insufficient_quota | クレジット残高がありません。コンソールでチャージしてください。 |
| 403 | account_suspended | アカウントが停止されています(アプリトークンでは device_revoked など)。 |
| 404 | model_not_found | 存在しない、または無効化されたモデル ID。 |
| 429 | rate_limit_exceeded | レート制限超過。Retry-After 秒待って再試行してください。 |
| 429 | too_many_concurrent_requests | 同時実行数の上限(1アカウントあたり4件)を超えました。進行中のリクエストの完了を待って再試行してください。 |
| 502 | upstream_error | 上流モデルの応答エラー。時間をおいて再試行してください。 |
| 503 | maintenance | メンテナンス中。Retry-After 後に再試行してください。 |
料金
前払いクレジット(USD)からの従量課金です。1リクエストの料金 = (入力トークン × 入力単価 + 出力トークン × 出力単価) ÷ 1,000,000(切り上げ、0.000001 USD 単位)。
| モデル ID | 入力 | 出力 | コンテキスト |
|---|---|---|---|
| synthia-max | $8.00 / MTok | $40.00 / MTok | 200,000 |
| synthia-pro | $4.00 / MTok | $20.00 / MTok | 200,000 |
| synthia-lite | $0.20 / MTok | $1.00 / MTok | 200,000 |
レート制限
API キーごとに毎分 60 リクエストまで(トークンバケット)。超過すると 429 と Retry-After ヘッダーを返します。
- 同時実行:1アカウントあたり最大 4 件まで処理中にできます。超えると 429
too_many_concurrent_requests。 - 出力上限:
max_tokens(またはmax_completion_tokens)は最大 32,768。未指定時も同じ上限が適用され、残高で支払える範囲まで自動的に引き下げられることがあります。
