curl --request POST \
--url https://direct.evolink.ai/v1/chat/completions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-3.6-flash",
"messages": [
{
"role": "user",
"content": "Please introduce yourself"
}
]
}
'{
"id": "chatcmpl-20251010015944503180122WJNB8Eid",
"model": "gemini-3.6-flash",
"object": "chat.completion",
"created": 1760032810,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! I'm pleased to introduce myself.\n\nI'm a Large Language Model, trained and developed by Google.\n\nSimply put, you can think of me as a \"smart brain\" that has been trained on massive amounts of text data and is able to understand and generate human language. My core capability is processing and generating text. Specifically, I can do the following:\n\n**1. Information Query & Knowledge Answering**\nI can act like a \"talking encyclopedia,\" answering various questions, whether they're about scientific knowledge, historical events, or everyday facts.\n\n**2. Creative Writing & Text Generation**\nI can create various types of text based on your requirements, such as:\n* **Writing**: Poetry, stories, scripts, emails, speeches, advertising copy, etc.\n* **Planning**: Travel plans, study outlines, event proposals, etc.\n* **Brainstorming**: Working with you to generate new ideas and spark creativity.\n\n**3. Translation & Language Processing**\nI'm proficient in multiple languages and can provide fast, fluent translation services. I can also help you polish, proofread, summarize, or rewrite text to make your expression clearer and more professional.\n\n**4. Programming & Code Assistance**\nI can write code snippets, explain code logic, debug errors, or \"translate\" code from one programming language to another, making me a helpful companion for programmers.\n\n**5. Logical Analysis & Reasoning**\nI can help you analyze complex problems, organize logical chains, and make inferences and summaries based on the information you provide.\n\n---\n\n**In summary**, my goal is to be a powerful and useful tool that helps you obtain information more efficiently, complete tasks, and spark creativity through natural language communication.\n\n**Remember:** I'm an artificial intelligence, my knowledge comes from the data I've learned, and it may not be the most up-to-date. Sometimes I may also make mistakes, so for very important information, I recommend you verify it again.",
"tool_calls": [
{
"id": "<string>",
"type": "function",
"function": {
"name": "<string>",
"arguments": "<string>"
}
}
]
},
"logprobs": {
"content": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
],
"top_logprobs": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
]
}
]
}
]
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 13,
"completion_tokens": 1891,
"total_tokens": 1904,
"prompt_tokens_details": {
"cached_tokens": 0,
"text_tokens": 13,
"audio_tokens": 0,
"image_tokens": 0
},
"completion_tokens_details": {
"text_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 1480
},
"input_tokens": 0,
"output_tokens": 0,
"input_tokens_details": null
}
}{
"error": {
"code": 400,
"message": "無効なリクエストパラメータ",
"type": "invalid_request_error"
}
}{
"error": {
"code": 401,
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": 402,
"message": "クォータ不足",
"type": "insufficient_quota_error",
"fallback_suggestion": "https://evolink.ai/dashboard/billing"
}
}{
"error": {
"code": 403,
"message": "Access denied for this model",
"type": "permission_error",
"param": "model"
}
}{
"error": {
"code": 404,
"message": "Specified model not found",
"type": "not_found_error",
"param": "model",
"fallback_suggestion": "gemini-3.6-flash"
}
}{
"error": {
"code": 413,
"message": "Image file too large",
"type": "request_too_large_error",
"param": "content",
"fallback_suggestion": "compress image to under 10MB"
}
}{
"error": {
"code": 429,
"message": "レート制限を超過しました",
"type": "rate_limit_error",
"fallback_suggestion": "retry after 60 seconds"
}
}{
"error": {
"code": 500,
"message": "内部サーバーエラー",
"type": "internal_server_error",
"fallback_suggestion": "try again later"
}
}{
"error": {
"code": 502,
"message": "Upstream AI service unavailable",
"type": "upstream_error",
"fallback_suggestion": "try different model"
}
}{
"error": {
"code": 503,
"message": "サービス一時利用不可",
"type": "service_unavailable_error",
"fallback_suggestion": "retry after 30 seconds"
}
}Gemini 全モデルインターフェース - OpenAI 互換形式
リクエストボディ内の model で呼び出す Gemini テキストモデルを選択します(すべての選択可能な値は model パラメータの対照表を参照してください)。
- OpenAI SDK / Chat Completions 形式を使用し、会話内容を同期的に返却します
- プレーンテキスト / マルチモーダル入力:テキスト + 画像の混合入力(
messages[].content) - ストリーミング:
stream: trueを設定するとチャンクごとに返却します
モデルの仕様と差異
- 3.8 の動作:3.7 と比べて、ソフトウェアエンジニアリング、エージェント、多段階推論、マルチモーダル精度が向上しています。特に
highでは、推論 / 出力 Token の消費が増える場合があります。レイテンシ重視ならlow、一般用途ならデフォルトのmedium、複雑なコード、長い動画、多段階推論にはhighを推奨します。 - サンプリング / ペナルティパラメータ
temperature/top_p/frequency_penalty/presence_penalty:Gemini 3.x 全シリーズ共通で、カスタム値は出力に影響しません。temperature/top_pが範囲を超えると 400 が返り、frequency_penalty/presence_penaltyは無視され、効果がありません(エラーにはなりません)。 - 思考制御
reasoning_effort:minimal/low/medium/high(各モデルが対応する段階とデフォルトはreasoning_effortパラメータを参照)。Gemini 3.x シリーズのみ有効です。gemini-3.8-flash/gemini-3.7-flashと Pro 系はminimalに対応しておらず、指定すると自動的にlowに引き下げられます。 - 最終ターンのロール:最後のメッセージの
roleをassistantにすることはできません(Gemini 3.5+ ではエラーになります)。 - Token 上限:
gemini-3.8-flash/gemini-3.7-flash/gemini-3.6-flash/gemini-3.5-flash-liteはコンテキスト 1,048,576、最大出力 65,536。その他のモデルは各自の仕様に準じます。
curl --request POST \
--url https://direct.evolink.ai/v1/chat/completions \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"model": "gemini-3.6-flash",
"messages": [
{
"role": "user",
"content": "Please introduce yourself"
}
]
}
'{
"id": "chatcmpl-20251010015944503180122WJNB8Eid",
"model": "gemini-3.6-flash",
"object": "chat.completion",
"created": 1760032810,
"choices": [
{
"index": 0,
"message": {
"role": "assistant",
"content": "Hello! I'm pleased to introduce myself.\n\nI'm a Large Language Model, trained and developed by Google.\n\nSimply put, you can think of me as a \"smart brain\" that has been trained on massive amounts of text data and is able to understand and generate human language. My core capability is processing and generating text. Specifically, I can do the following:\n\n**1. Information Query & Knowledge Answering**\nI can act like a \"talking encyclopedia,\" answering various questions, whether they're about scientific knowledge, historical events, or everyday facts.\n\n**2. Creative Writing & Text Generation**\nI can create various types of text based on your requirements, such as:\n* **Writing**: Poetry, stories, scripts, emails, speeches, advertising copy, etc.\n* **Planning**: Travel plans, study outlines, event proposals, etc.\n* **Brainstorming**: Working with you to generate new ideas and spark creativity.\n\n**3. Translation & Language Processing**\nI'm proficient in multiple languages and can provide fast, fluent translation services. I can also help you polish, proofread, summarize, or rewrite text to make your expression clearer and more professional.\n\n**4. Programming & Code Assistance**\nI can write code snippets, explain code logic, debug errors, or \"translate\" code from one programming language to another, making me a helpful companion for programmers.\n\n**5. Logical Analysis & Reasoning**\nI can help you analyze complex problems, organize logical chains, and make inferences and summaries based on the information you provide.\n\n---\n\n**In summary**, my goal is to be a powerful and useful tool that helps you obtain information more efficiently, complete tasks, and spark creativity through natural language communication.\n\n**Remember:** I'm an artificial intelligence, my knowledge comes from the data I've learned, and it may not be the most up-to-date. Sometimes I may also make mistakes, so for very important information, I recommend you verify it again.",
"tool_calls": [
{
"id": "<string>",
"type": "function",
"function": {
"name": "<string>",
"arguments": "<string>"
}
}
]
},
"logprobs": {
"content": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
],
"top_logprobs": [
{
"token": "<string>",
"logprob": 123,
"bytes": [
123
]
}
]
}
]
},
"finish_reason": "stop"
}
],
"usage": {
"prompt_tokens": 13,
"completion_tokens": 1891,
"total_tokens": 1904,
"prompt_tokens_details": {
"cached_tokens": 0,
"text_tokens": 13,
"audio_tokens": 0,
"image_tokens": 0
},
"completion_tokens_details": {
"text_tokens": 0,
"audio_tokens": 0,
"reasoning_tokens": 1480
},
"input_tokens": 0,
"output_tokens": 0,
"input_tokens_details": null
}
}{
"error": {
"code": 400,
"message": "無効なリクエストパラメータ",
"type": "invalid_request_error"
}
}{
"error": {
"code": 401,
"message": "Invalid or expired token",
"type": "authentication_error"
}
}{
"error": {
"code": 402,
"message": "クォータ不足",
"type": "insufficient_quota_error",
"fallback_suggestion": "https://evolink.ai/dashboard/billing"
}
}{
"error": {
"code": 403,
"message": "Access denied for this model",
"type": "permission_error",
"param": "model"
}
}{
"error": {
"code": 404,
"message": "Specified model not found",
"type": "not_found_error",
"param": "model",
"fallback_suggestion": "gemini-3.6-flash"
}
}{
"error": {
"code": 413,
"message": "Image file too large",
"type": "request_too_large_error",
"param": "content",
"fallback_suggestion": "compress image to under 10MB"
}
}{
"error": {
"code": 429,
"message": "レート制限を超過しました",
"type": "rate_limit_error",
"fallback_suggestion": "retry after 60 seconds"
}
}{
"error": {
"code": 500,
"message": "内部サーバーエラー",
"type": "internal_server_error",
"fallback_suggestion": "try again later"
}
}{
"error": {
"code": 502,
"message": "Upstream AI service unavailable",
"type": "upstream_error",
"fallback_suggestion": "try different model"
}
}{
"error": {
"code": 503,
"message": "サービス一時利用不可",
"type": "service_unavailable_error",
"fallback_suggestion": "retry after 30 seconds"
}
}https://direct.evolink.ai で、テキストモデルへの対応が優れており、長時間接続をサポートします。https://api.evolink.ai はマルチモーダルの主力エンドポイントで、テキストモデルに対しては代替アドレスとして使用されます。承認
##すべてのAPIにBearer Token認証が必要です##
APIキーの取得:
APIキー管理ページにアクセスしてAPIキーを取得してください
リクエストヘッダーに追加:
Authorization: Bearer YOUR_API_KEY
ボディ
呼び出す Gemini テキストモデルを選択します:
| モデル ID | シリーズ | 位置づけ |
|---|---|---|
gemini-3.8-flash | 3.8 Flash | ソフトウェアエンジニアリング / エージェント / 多段階推論 / マルチモーダル精度を強化 |
gemini-3.7-flash | 3.7 Flash | Pro 級 agentic / コード生成 / ターミナル実行 |
gemini-3.6-flash | 3.6 Flash | マルチステップ編成 / コードリファクタリング / 汎用推論 |
gemini-3.5-flash | 3.5 Flash | 汎用 Flash |
gemini-3.5-flash-lite | 3.5 Flash-Lite | 低コスト / 高スループット / 軽量 agent |
gemini-3.1-pro-preview | 3.1 Pro (Preview) | 高度な推論 |
gemini-3.1-pro-preview-customtools | 3.1 Pro · CustomTools | 高度な推論 + カスタムツール |
gemini-3.1-flash-lite-preview | 3.1 Flash-Lite (Preview) | 低コスト |
gemini-3-pro-preview | 3.0 Pro (Preview) | 高度な推論 |
gemini-3-flash-preview | 3.0 Flash (Preview) | 汎用 Flash |
gemini-2.5-pro | 2.5 Pro | 高度な推論 |
gemini-2.5-flash | 2.5 Flash | 汎用 Flash |
gemini-2.5-flash-lite | 2.5 Flash-Lite | 低コスト |
gemini-3.8-flash, gemini-3.7-flash, 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"
チャットメッセージのリスト、マルチターン対話とマルチモーダル入力をサポート
1Show child attributes
Show child attributes
ストリーミングモードでレスポンスを返すかどうか
true: ストリーミング返却、リアルタイムでチャンク単位にコンテンツを受信false: 完全なレスポンスを一括で返却
false
Maximum number of completion tokens for the generated response, corresponding to Gemini's maxOutputTokens.
gemini-3.8-flash / gemini-3.7-flash / gemini-3.6-flash / gemini-3.5-flash-lite は上限 65,536 tokens。その他のモデルは各自の仕様に準じます。
1 <= x <= 655362000
Maximum number of tokens for the generated response, compatible with the legacy OpenAI parameter.
1 <= x <= 655362000
サンプリング温度、出力のランダム性を制御
説明:
- 低い値(例: 0.2): より決定論的で集中した出力
- 高い値(例: 1.5): よりランダムで創造的な出力
Gemini 3.x 全シリーズ共通(モデルによって異なりません):正当な範囲内のカスタム値は出力に影響しません。このパラメータの正当な範囲を超えると、静かに無視されるのではなく 400 が返ります。
0 <= x <= 20.7
核サンプリング(Nucleus Sampling)パラメータ
説明:
- 累積確率が上位どこまでのトークンからサンプリングするかを制御します
- 例えば 0.9 は累積確率が90%に達するまでのトークンから選択することを意味します
- デフォルト値: 0.95
推奨: temperature と top_p を同時に調整しないでください
Gemini 3.x 全シリーズ共通(モデルによって異なりません):正当な範囲内のカスタム値は出力に影響しません。このパラメータの正当な範囲を超えると、静かに無視されるのではなく 400 が返ります。
0 <= x <= 10.9
Frequency penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's frequencyPenalty.
Gemini 3.x 全シリーズ共通:指定しても無視され、有効になりません(エラーにはなりません)。
-2 <= x <= 20
Presence penalty coefficient. Range: -2.0 to 2.0. Corresponds to Gemini's presencePenalty.
Gemini 3.x 全シリーズ共通:指定しても無視され、有効になりません(エラーにはなりません)。
-2 <= x <= 20
Stop sequences. Supports a string or string array, corresponding to Gemini's stopSequences.
生成する候補の数
Gemini 3.x は 1 のみサポートします。>1 を指定すると 400 が返ります(native で既に削除された candidateCount に相当します)。
1 <= x <= 11
思考の作業量を制限します。Gemini の思考レベルに対応します:
minimal:思考をほとんど行わず、高スループット / 低レイテンシlow:思考は少なめで、単純なタスク向けmedium:品質と速度のバランスhigh:深いマルチステップ推論
Gemini 3.x シリーズのみ有効で、各モデルが対応する段階とデフォルトは異なります(ネイティブと同じ):
| モデル | 対応段階 | デフォルト |
|---|---|---|
gemini-3.8-flash | low / medium / high | medium |
gemini-3.7-flash | low / medium / high | medium |
gemini-3.6-flash | minimal / low / medium / high | medium |
gemini-3.5-flash | minimal / low / medium / high | medium |
gemini-3.5-flash-lite | minimal / low / medium / high | minimal |
gemini-3.1-flash-lite-preview | minimal / low / medium / high | minimal |
gemini-3-flash-preview | minimal / low / medium / high | medium |
gemini-3.1-pro-preview | low / medium / high | high |
gemini-3.1-pro-preview-customtools | low / medium / high | high |
gemini-3-pro-preview | low / medium / high | high |
モデルが対応していない段階を指定した場合(例えば Pro 系や gemini-3.8-flash / gemini-3.7-flash に minimal を渡した場合)は自動的に low に引き下げられ、エラーにはなりません。
minimal, low, medium, high "minimal"
Random seed used to make output as reproducible as possible, corresponding to Gemini's seed.
12345
Response format settings, supporting JSON mode and JSON Schema, corresponding to Gemini's responseMimeType, responseSchema and responseJsonSchema.
- Option 1
- Option 2
Show child attributes
Show child attributes
Streaming response options. Can be set when stream is true.
Show child attributes
Show child attributes
List of tool definitions for Function Calling.
Show child attributes
Show child attributes
Controls tool-calling behavior.
none, auto, required Gemini extension parameters.
Show child attributes
Show child attributes
レスポンス
チャット補完が正常に生成されました
チャット補完の一意の識別子
"chatcmpl-20251010015944503180122WJNB8Eid"
実際に使用されたモデル名
"gemini-3.6-flash"
レスポンスタイプ
chat.completion "chat.completion"
作成タイムスタンプ
1760032810
チャット補完選択肢のリスト
Show child attributes
Show child attributes
トークン使用統計
Show child attributes
Show child attributes