ドキュメント APIリファレンス SDKリファレンスエージェント利用 AIスキル

チャット

チャットを作成

指定されたチャット会話に対するモデルの応答をリクエストします。ストリーミングと非ストリーミングの両モードに対応し、すべてのモデル・プロバイダーで単一のOpenAI互換リクエスト/レスポンス形式を使用します。

POST/api/v1/chat/completions

認証

Authorization必須

string · header

Authorization ヘッダーに Bearer トークンとして API キーを渡します。

Body

model必須

string

使用するモデル。プロバイダー修飾形式、例:"openai/gpt-4.1"。一般的なモデルファミリーの短縮 id(例:"gpt-4o")は完全な canonical id("openai/gpt-4o")に自動解決されます。すでに canonical 形式の値はそのまま通過します。認識できない短縮 id は強制的に書き換えられず、モデル解決の段階で明確な「モデルが見つかりません」エラーが返されます。

minLength: 1

Example: "openai/gpt-4.1"

messages必須

Message[]

会話メッセージの配列、最低1件。各メッセージにはrole(system/user/assistant/tool)とcontentがあります。

minLength: 1

models

string[]

フォールバックモデルリスト——順番に試行され、主モデルの候補グループがすべて失敗した場合にのみ使用されます。

stream

boolean

trueの場合はSSEでレスポンスをストリーミング。省略またはfalseの場合は単一のJSONレスポンスを返します。

temperature

number

サンプリング温度——高いほどランダム、低いほど決定的。

0–2

max_tokens

integer

レスポンスが生成できる最大トークン数。

max_completion_tokens

integer

max_tokensのエイリアスで、意味は同じです。

top_p

number

核サンプリング(nucleus sampling)のしきい値。

0–1

top_k

integer

サンプリングを確率上位K個のトークンに限定します。

frequency_penalty

number

既に出現した頻度に基づいてトークンを罰します。

-2.0–2.0

presence_penalty

number

出現回数に関わらず、既に出現したかどうかに基づいてトークンを罰します。

-2.0–2.0

repetition_penalty

number

繰り返しトークンのペナルティ係数——frequency/presence penaltyとは別の仕組みです。

min_p

number

最も可能性の高いトークンに対する最小確率しきい値。

0–1

top_a

number

もう一つの動的カットオフサンプリング機構で、最高確率の二乗によってしきい値をスケーリングします。

seed

integer

決定論的サンプリングシード。すべてのプロバイダーが再現性を保証するわけではありません。

n

integer

生成する応答の数。

stop

string | string[]

生成を停止する文字列、最大4個。

tools

Tool[]

モデルが呼び出せるツール/関数定義のリスト。

tool_choice

string | object

モデルがツールを呼び出すかどうか/どのように強制されるかを制御します。

parallel_tool_calls

boolean

toolsが提供されている場合に並列ツール呼び出しを許可するかどうか。デフォルトはtrue。 OpenAI系モデルのみ対応——対象モデルがOpenAI自身のものでない場合、このフィールドは静かに除去されます（エラーにはなりません）。

response_format

object

出力形式を制限します。例:{type:"json_object"} またはJSON Schemaを含む{type:"json_schema"}。

logit_bias

object

トークンIDを、サンプリング前に加算される[-100, 100]のバイアス値にマッピングします。 OpenAI系モデルのみ対応——対象モデルがOpenAI自身のものでない場合、このフィールドは静かに除去されます（エラーにはなりません）。

logprobs

boolean

各出力トークンの対数確率を返します。 OpenAI系モデルのみ対応——対象モデルがOpenAI自身のものでない場合、このフィールドは静かに除去されます（エラーにはなりません）。

top_logprobs

integer

各位置で返す最も可能性の高いトークン数(logprobs: trueが必要)。 OpenAI系モデルのみ対応——対象モデルがOpenAI自身のものでない場合、このフィールドは静かに除去されます（エラーにはなりません）。

0–20

user

string

モニタリングと不正検出用のエンドユーザー識別子。課金には影響なし。 OpenAI系モデルのみ対応——対象モデルがOpenAI自身のものでない場合、このフィールドは静かに除去されます（エラーにはなりません）。

reasoning

object

推論モデルの思考制御オブジェクト(例:{effort, max_tokens})。

reasoning_effort

string

reasoning.effortの簡略形式フィールド。

lowmediumhigh

image_config

object

画像生成/編集オプション(modalitiesにimageが含まれる場合に使用)。

modalities

string[]

要求される出力モダリティ。imageを含む場合、画像生成ディスパッチパスを通ります。

textimage

plugins

object[]

プラグインの配列(例:Web検索を有効にする{id:"web"})。一部のモデルルートのみ対応、非対応の場合は無効。:onlineモデルバリアントは自動的に{id:"web"}を注入しますが、これも対応ルートに限られます。

POST /api/v1/chat/completions

1
2
3
4
5
6
7
curl https://bazaarlink.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1",
    "messages": [{"role": "user", "content": "Explain quantum computing in one paragraph."}]
  }'

レスポンス例

成功。BazaarLinkが正規化するのはmodelとproviderフィールドの削除の2点のみで、それ以外のアップストリームレスポンス(native_finish_reason、system_fingerprint、reasoningなど、該当プロバイダーが設定している場合にのみ存在するフィールドを含む)はそのまま転送されます。usage.costは例外で、常にBazaarLink自身が確定した金額であり、アップストリームから転送された値ではありません。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1740000000,
  "model": "openai/gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Quantum computing leverages quantum mechanics..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 28,
    "completion_tokens": 74,
    "total_tokens": 102,
    "cost": 0.000648
  }
}