メインコンテンツへスキップ
POST
BaseURL:デフォルトの BaseURL は https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。

承認

Authorization
string
header
必須

##すべてのAPIにBearer Token認証が必要です##

APIキーの取得:

APIキー管理ページにアクセスしてAPIキーを取得してください

リクエストヘッダーに追加:

ボディ

application/json
model
enum<string>
必須

呼び出す Gemini テキストモデルを選択します:

利用可能なオプション:
gemini-3.6-flash,
gemini-3.5-flash,
gemini-3.5-flash-lite,
gemini-3.1-pro-preview,
gemini-3.1-pro-preview-customtools,
gemini-3.1-flash-lite-preview,
gemini-3-pro-preview,
gemini-3-flash-preview,
gemini-2.5-pro,
gemini-2.5-flash,
gemini-2.5-flash-lite
:

"gemini-3.6-flash"

messages
object[]
必須

チャットメッセージのリスト、マルチターン対話とマルチモーダル入力をサポート

Minimum array length: 1
stream
boolean
デフォルト:false

ストリーミングモードでレスポンスを返すかどうか

  • true: ストリーミング返却、リアルタイムでチャンク単位にコンテンツを受信
  • false: 完全なレスポンスを一括で返却
:

false

max_completion_tokens
integer | null

Maximum number of completion tokens for the generated response, corresponding to Gemini's maxOutputTokens.

gemini-3.6-flash / gemini-3.5-flash-lite は上限 65,536 tokens。その他のモデルは各自の仕様に準じます。

必須範囲: 1 <= x <= 65536
:

2000

max_tokens
integer

Maximum number of tokens for the generated response, compatible with the legacy OpenAI parameter.

必須範囲: 1 <= x <= 65536
:

2000

temperature
number
デフォルト:1

サンプリング温度、出力のランダム性を制御

説明:

  • 低い値(例: 0.2): より決定論的で集中した出力
  • 高い値(例: 1.5): よりランダムで創造的な出力

⚠️ Gemini 3.x 全シリーズ共通(モデルによって異なりません):正当な範囲内のカスタム値は出力に影響しません。このパラメータの正当な範囲を超えると、静かに無視されるのではなく 400 が返ります。

必須範囲: 0 <= x <= 2
:

0.7

top_p
number
デフォルト:0.95

核サンプリング(Nucleus Sampling)パラメータ

説明:

  • 累積確率が上位どこまでのトークンからサンプリングするかを制御します
  • 例えば 0.9 は累積確率が90%に達するまでのトークンから選択することを意味します
  • デフォルト値: 0.95

推奨: temperature と top_p を同時に調整しないでください

⚠️ Gemini 3.x 全シリーズ共通(モデルによって異なりません):正当な範囲内のカスタム値は出力に影響しません。このパラメータの正当な範囲を超えると、静かに無視されるのではなく 400 が返ります。

必須範囲: 0 <= x <= 1
:

0.9

frequency_penalty
number | null
デフォルト:0

Frequency penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's frequencyPenalty.

⚠️ Gemini 3.x 全シリーズ共通:指定してもゲートウェイでフィルタされ、有効になりません(エラーにはなりません)。

必須範囲: -2 <= x <= 2
:

0

presence_penalty
number | null
デフォルト:0

Presence penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's presencePenalty.

⚠️ Gemini 3.x 全シリーズ共通:指定してもゲートウェイでフィルタされ、有効になりません(エラーにはなりません)。

必須範囲: -2 <= x <= 2
:

0

stop

Stop sequences. Supports a string or string array, corresponding to Gemini's stopSequences.

n
integer | null
デフォルト:1

生成する候補の数

⚠️ Gemini 3.x は 1 のみサポートします。>1 を指定すると 400 が返ります(native で既に削除された candidateCount に相当します)。

必須範囲: 1 <= x <= 1
:

1

reasoning_effort
enum<string> | null

思考の作業量を制限します。Gemini の思考レベルに対応します:

  • minimal:思考をほとんど行わず、高スループット / 低レイテンシ
  • low:思考は少なめで、単純なタスク向け
  • medium:品質と速度のバランス
  • high:深いマルチステップ推論

Gemini 3.x シリーズのみ有効で、各モデルが対応する段階とデフォルトは異なります(ネイティブと同じ):

利用可能なオプション:
minimal,
low,
medium,
high
:

"minimal"

seed
integer | null

Random seed used to make output as reproducible as possible, corresponding to Gemini's seed.

:

12345

response_format
object

Response format settings, supporting JSON mode and JSON Schema, corresponding to Gemini's responseMimeType, responseSchema and responseJsonSchema.

stream_options
object | null

Streaming response options. Can be set when stream is true.

tools
object[] | null

List of tool definitions for Function Calling.

tool_choice

Controls tool-calling behavior.

利用可能なオプション:
none,
auto,
required
extra_body
object | null

Gemini extension parameters.

レスポンス

チャット補完が正常に生成されました

id
string

チャット補完の一意の識別子

:

"chatcmpl-20251010015944503180122WJNB8Eid"

model
string

実際に使用されたモデル名

:

"gemini-3.6-flash"

object
enum<string>

レスポンスタイプ

利用可能なオプション:
chat.completion
:

"chat.completion"

created
integer

作成タイムスタンプ

:

1760032810

choices
object[]

チャット補完選択肢のリスト

usage
object

トークン使用統計