ドキュメントはじめにクイックスタート

クイックスタート

API キーを作成し、任意の方言で数分以内に最初の呼び出しを行います。

このページでは最小構成の統合手順を説明します：キー作成 → 最初のリクエスト送信 → 利用状況の確認。

ステップ 1：API キーを作成

登録してコンソールにログインし、「API Key」ページでキーを作成します。キーは sk-sole-… の形式です。

完全なキーは作成時に一度だけ表示され、サーバーにはハッシュのみ保存されます。すぐにシークレットマネージャーや環境変数に保存してください。紛失した場合は再作成が必要です。

ステップ 2：最初の呼び出し（OpenAI 互換）

まずは Responses API から始めることをおすすめします。Codex などのコーディングツールが実際に使っているエンドポイントです：

bash
curl https://api.soleapi.com/v1/responses \
  -H "Authorization: Bearer $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "input": "Say hello in one sentence"
  }'

Anthropic 形式（Messages API）

Anthropic SDK や Claude Code を使う場合は、x-api-key ヘッダーで /v1/messages を呼び出します：

bash
curl https://api.soleapi.com/v1/messages \
  -H "x-api-key: $SOLEAPI_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-fable-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Say hello in one sentence"}]
  }'

Gemini 形式

Google GenAI SDK では /v1beta エンドポイントと x-goog-api-key ヘッダーを使用します：

bash
curl "https://api.soleapi.com/v1beta/models/gemini-2.5-pro:generateContent" \
  -H "x-goog-api-key: $SOLEAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"parts": [{"text": "Say hello in one sentence"}]}]
  }'

Gemini 方言では ?key= クエリパラメータでのキー指定はできません。必ず x-goog-api-key ヘッダーで指定してください。詳細は認証を参照。

ステップ 3：利用状況と請求の確認

コンソールではリアルタイム残高、利用トレンド、キー別統計、リクエスト単位の明細を確認できます。課金の仕組みは課金と残高を参照してください。

次のステップ