curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/gemini-3.5-flash:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Please introduce yourself"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "cachedContentTokenCount": 0
  },
  "modelVersion": "gemini-3.5-flash",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

{
  "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"
  }
}

{
  "error": {
    "code": 404,
    "message": "Model not found",
    "type": "not_found_error"
  }
}

{
  "error": {
    "code": 413,
    "message": "リクエストボディが大きすぎます",
    "type": "request_too_large_error",
    "fallback_suggestion": "reduce file size"
  }
}

{
  "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 again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "サービス一時利用不可",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Google Native API Format

Gemini 3.5 Flash - Native API - 完全なリファレンス

Google Native API形式でgemini-3.5-flashモデルを呼び出し
同期処理モードを使用可能、会話内容をリアルタイムで返却
プレーンテキスト会話: シングルターンまたはマルチターンのコンテキスト対話、コードサンプルのsimple_textおよびmulti_turnの例を参照
マルチモーダル入力: テキスト+画像/オーディオ/ビデオの混合入力をサポート、コードサンプルのaudio_analysis、image_understanding、multi_fileの例を参照
パラメータチューニング: generationConfigで生成品質を制御
ストリーミング: URL の generateContent を streamGenerateContent に置き換えてください

POST

v1beta

models

gemini-3.5-flash:generateContent

curl --request POST \
  --url https://direct.evolink.ai/v1beta/models/gemini-3.5-flash:generateContent \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Please introduce yourself"
        }
      ]
    }
  ]
}
'

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google...",
            "thought": true,
            "thoughtSignature": "<Signature_A>"
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ],
    "cachedContentTokenCount": 0
  },
  "modelVersion": "gemini-3.5-flash",
  "responseId": "l-LoaPu0BPmo1dkP6ZPHiQc"
}

{
  "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"
  }
}

{
  "error": {
    "code": 404,
    "message": "Model not found",
    "type": "not_found_error"
  }
}

{
  "error": {
    "code": 413,
    "message": "リクエストボディが大きすぎます",
    "type": "request_too_large_error",
    "fallback_suggestion": "reduce file size"
  }
}

{
  "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 again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "サービス一時利用不可",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

ストリーミング：URL の generateContent を streamGenerateContent に置き換えてください。リクエストボディのパラメータは同一です。レスポンスはストリーミングでチャンクごとに返されます。レスポンス形式は下記の「ストリーミングレスポンス」を参照してください。

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

承認

Authorization

string

header

必須

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

APIキーの取得：

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

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

Authorization: Bearer YOUR_API_KEY

ボディ

application/json

contents

object[]

必須

List of conversation contents, supports multi-turn dialogue and multimodal input

Minimum array length: 1

Show child attributes

generationConfig

object

Generation configuration parameters (optional)

Show child attributes

systemInstruction

object

System instruction (optional), mainly text content

Show child attributes

tools

object[]

List of tools the model can call, such as function calling or code execution

toolConfig

object

Tool calling configuration (optional)

safetySettings

object[]

Safety settings list (optional)

cachedContent

string

Cached content name, in the form cachedContents/{cachedContent}

レスポンス

コンテンツが正常に生成されました

レスポンス形式の説明：

generateContent エンドポイント使用時、GenerateContentResponseを返却（完全なレスポンスを一度に返却）
streamGenerateContent エンドポイント使用時、StreamGenerateContentResponseを返却（ストリーミングレスポンス、コンテンツをチャンクで返却）

同期レスポンス
ストリームレスポンス

candidates

object[]

List of candidate responses

Show child attributes

promptFeedback

object

Show child attributes

usageMetadata

object

使用統計

Show child attributes

modelVersion

string

Model version

例:

"gemini-3.5-flash"

responseId

string

Response ID

例:

"l-LoaPu0BPmo1dkP6ZPHiQc"

Gemini 3.5 Flash - Native API - クイックスタート Gemini 3.1 Pro - OpenAI SDK - クイックスタート

画像シリーズ

動画シリーズ

オーディオシリーズ

テキストシリーズ

アカウント管理

タスク管理

ファイル管理

Gemini 3.5 Flash - Native API - 完全なリファレンス

承認

ボディ

レスポンス