Roko API
コンソール

ドキュメント

OpenAI 互換 API

2026-07-21に更新

/v1/chat/completions はベンダー横断で最も汎用的な主要エンドポイントです。公式 OpenAI SDK の Base URL を https://api.rokoapi.com/v1に変更するだけで、当サイトの公開済みモデルを呼び出せます。

本ページは「互換モード」での接続について説明しています。OpenAI Responses ネイティブプロトコルが必要な場合は、Responses API を参照してください。

互換モードを使う理由

  • コード1つで複数モデル対応：同じ SDK で DeepSeek、OpenAI、画像モデルなどの公開済みチャネルを呼び出せます
  • エコシステムの成熟度：LangChain、各種 IDE プラグイン、プロキシクライアントはデフォルトで Chat Completions を使用します
  • 移行コストが低い：base_url / baseURL と model を変更するだけで済みます

Responses に切り替えるタイミング：Responses の構造化された output、セマンティックなストリーミングイベント、または上流がそのエンドポイントでのみ提供する機能が必要な場合 —— Responses API。

クイックスタート

curl https://api.rokoapi.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [
      {"role": "system", "content": "簡潔に回答するアシスタントです"},
      {"role": "user", "content": "自己紹介を一文で書いてください"}
    ]
  }'
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.rokoapi.com/v1",
)

resp = client.chat.completions.create(
    model="deepseek-v4-flash",
    messages=[
        {"role": "system", "content": "簡潔に回答するアシスタントです"},
        {"role": "user", "content": "自己紹介を一文で書いてください"},
    ],
)
print(resp.choices[0].message.content)
import OpenAI from 'openai'

const client = new OpenAI({
  apiKey: 'YOUR_API_KEY',
  baseURL: 'https://api.rokoapi.com/v1',
})

const resp = await client.chat.completions.create({
  model: 'deepseek-v4-flash',
  messages: [
    { role: 'system', content: '簡潔に回答するアシスタントです' },
    { role: 'user', content: '自己紹介を一文で書いてください' },
  ],
})

console.log(resp.choices[0]?.message?.content)

model model には 公開済みモデル開発ガイド に記載されている実際のモデル ID を指定してください。未公開の名称は使用しないでください。

リクエストパラメータのクイックリファレンス

パラメータ型説明
modelstring必須。公開済みモデルの ID
messagesarray必須。会話メッセージ
streambooleantrue が true の場合、SSE で応答を返します
temperaturenumberサンプリング温度。一部の推論モデルでは非対応の場合があります
max_tokens / max_completion_tokensint最大出力トークン数
tools / tool_choice—関数呼び出し。モデルやチャネルによるサポート状況が異なります
response_formatobjectJSON などの出力形式の制約

詳細なフィールド説明は Chat Completions。

レスポンス構造

成功時は標準的な Chat Completion JSON を返します。テキストは choices[0].message.contentに格納されます。エラー時は通常 error.message（および任意の error.type / error.code）。

ストリーミング出力

"stream": true を設定してください。ストリーミングの詳細は [ストリーミングリクエスト]( "stream": true) を参照してください。/docs/streaming/)。

画像などの非テキスト機能

画像生成などは対応エンドポイント（例： /v1/images/generations）を使用し、model を画像モデルの ID に変更してください。各シリーズの使用例はサイドバーの「公開済みモデル」を参照してください。 model 画像モデルの ID に置き換えてください。各シリーズの例は、サイドバーの「公開済みモデル」を参照してください。

関連リンク