本文へスキップ
AI-SNS.IO SYNTHIA

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"}} で返ります。

HTTPcode意味・対処
401invalid_api_keyキーがない・誤り・無効化済み。
402insufficient_quotaクレジット残高がありません。コンソールでチャージしてください。
403account_suspendedアカウントが停止されています(アプリトークンでは device_revoked など)。
404model_not_found存在しない、または無効化されたモデル ID。
429rate_limit_exceededレート制限超過。Retry-After 秒待って再試行してください。
429too_many_concurrent_requests同時実行数の上限(1アカウントあたり4件)を超えました。進行中のリクエストの完了を待って再試行してください。
502upstream_error上流モデルの応答エラー。時間をおいて再試行してください。
503maintenanceメンテナンス中。Retry-After 後に再試行してください。

料金

前払いクレジット(USD)からの従量課金です。1リクエストの料金 = (入力トークン × 入力単価 + 出力トークン × 出力単価) ÷ 1,000,000(切り上げ、0.000001 USD 単位)。

モデル ID入力出力コンテキスト
synthia-max$8.00 / MTok$40.00 / MTok200,000
synthia-pro$4.00 / MTok$20.00 / MTok200,000
synthia-lite$0.20 / MTok$1.00 / MTok200,000

レート制限

API キーごとに毎分 60 リクエストまで(トークンバケット)。超過すると 429 と Retry-After ヘッダーを返します。

  • 同時実行:1アカウントあたり最大 4 件まで処理中にできます。超えると 429 too_many_concurrent_requests。
  • 出力上限:max_tokens(または max_completion_tokens)は最大 32,768。未指定時も同じ上限が適用され、残高で支払える範囲まで自動的に引き下げられることがあります。