LLM クイックスタート - Sunra.ai

Sunra は3つの LLM API エンドポイントを提供しており、それぞれ異なるフォーマットに準拠しています。3つのエンドポイントはすべて同じ認証方式とベース URL（https://api-llm.sunra.ai）を使用するため、お使いの技術スタックに最適なフォーマットを選択できます。始める前に、ダッシュボードから API キーを取得してください。

Chat Completions — `/v1/chat/completions`

Chat Completions エンドポイントは OpenAI Chat Completions フォーマットに準拠しています。ロール（system、user、assistant）を持つメッセージのリストを受け取り、補完結果を返します。 OpenAI SDK やツールとのドロップイン互換性が必要な場合は、このエンドポイントを使用してください。 主な機能： ストリーミング、関数呼び出し、ビジョン（画像、音声、動画、ファイル）、推論、構造化出力（JSON schema / grammar）、logprobs。

curl -X POST https://api-llm.sunra.ai/v1/chat/completions \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [
      { "role": "system", "content": "You are a helpful assistant." },
      { "role": "user", "content": "What is the capital of France?" }
    ]
  }'

Anthropic Messages — `/v1/messages`

Anthropic Messages エンドポイントは Anthropic Messages API フォーマットに準拠しています。user / assistant のメッセージロールを使用し、リッチなコンテンツブロックと独立した system パラメータをサポートしています。 Anthropic Claude モデルへのネイティブアクセスや、拡張思考、プロンプトキャッシング、引用、組み込みツール（ウェブ検索、コード実行）などの機能が必要な場合は、このエンドポイントを使用してください。 主な機能： ストリーミング、拡張思考、プロンプトキャッシング、ツール使用（カスタム + 組み込み）、PDF/ドキュメント入力、引用、構造化出力。

curl -X POST https://api-llm.sunra.ai/v1/messages \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4-20250514",
    "max_tokens": 1024,
    "messages": [
      { "role": "user", "content": "Hello, how are you?" }
    ]
  }'

Responses — `/v1/responses`

Responses エンドポイントは OpenAI Responses API フォーマットに準拠しています。柔軟な入力項目（メッセージ、関数呼び出し、推論）を受け取り、構造化された出力項目を返します。組み込みウェブ検索、ファイル検索、コードインタープリター、コンピュータ使用、MCP ツール統合、画像生成など、最新の OpenAI Responses 機能が必要な場合は、このエンドポイントを使用してください。 主な機能： ストリーミング、関数呼び出し、ウェブ検索、ファイル検索、コードインタープリター、コンピュータ使用、MCP ツール、画像生成、推論、構造化出力。

curl -X POST https://api-llm.sunra.ai/v1/responses \
  -H "Authorization: Bearer <SUNRA_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4o",
    "input": [
      { "type": "message", "role": "user", "content": "Hello, how are you?" }
    ]
  }'

適切なエンドポイントの選択

	Chat Completions	Anthropic Messages	Responses
フォーマット	OpenAI Chat	Anthropic Messages	OpenAI Responses
最適な用途	OpenAI SDK 互換性	Claude ネイティブ機能	最新の OpenAI 機能
ストリーミング	SSE	SSE	SSE
関数呼び出し	はい	はい（カスタム + 組み込み）	はい
推論	はい	拡張思考	はい
構造化出力	JSON schema、grammar	JSON schema	JSON schema
組み込みツール	—	ウェブ検索、コード実行	ウェブ検索、ファイル検索、コードインタープリター、コンピュータ使用、MCP

3つのエンドポイントはすべて同じ認証方式を共有しています。Authorization ヘッダーに Bearer トークンとして API キーを渡すだけで利用できます。