API REFERENCE

LeapX API 文檔

通過統一接口調用多家主流大模型，支持文本對話、多模態理解、圖像/視頻/音頻生成、流式輸出等能力。完全兼容 OpenAI、Anthropic、Google Gemini 原生協議。

Base URL https://api.ai-leapx.com/v1

📖概述

LeapX 是一站式大模型 API 平臺，聚焦"降低模型應用門檻，加速場景智能化"。通過標準化接口與模塊化組件，將複雜的模型技術轉化爲可快速集成的能力積木。

核心能力

典型場景

🚀快速開始

三步開始調用

  1. 註冊賬號：訪問 ai-leapx.com，使用手機號驗證碼完成註冊，新用戶可領代金券。
  2. 開通模型：在控制臺「模型廣場」選擇需要的模型，開通按量付費或購買量包。
  3. 創建 API Key：進入「API Key 管理」創建專屬 Key，用於接口鑑權。

接入信息

項目值
Base URLhttps://api.ai-leapx.com/v1
Chat 接口https://api.ai-leapx.com/v1/chat/completions
鑑權方式Authorization: Bearer ${API_KEY}（Messages 接口使用 x-api-key；Gemini 原生使用 ?key= URL 參數）
請求類型Content-Type: application/json

第一次調用

cURL 
curl https://api.ai-leapx.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $LEAPX_API_KEY" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "你好"}
    ]
  }'
Python (openai) 
# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_LEAPX_API_KEY",
    base_url="https://api.ai-leapx.com/v1",
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)
Node.js (openai) 
// npm i openai
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.LEAPX_API_KEY,
  baseURL: "https://api.ai-leapx.com/v1",
});

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);
提示：LeapX 完全兼容 OpenAI SDK，只需把 base_url 改爲 https://api.ai-leapx.com/v1，API Key 換爲 LeapX Key，即可在保持原代碼不變的前提下調用所有 OpenAI 兼容模型。

🧭端點速覽

下表列出 LeapX 提供的全部 API 端點，按類別分組：

文本生成

方法路徑說明
POST/v1/chat/completionsOpenAI 兼容的對話/多模態接口（推薦）
POST/v1/responsesOpenAI Responses API（GPT 系列）
POST/v1/messagesAnthropic Messages 協議（Claude 等）
POST/v1beta/models/{model}:generateContentGoogle Gemini 原生協議
POST/v1beta/models/{model}:streamGenerateContentGemini 流式

圖片生成

方法路徑說明
POST/openai/v1/images/generations文生圖（OpenAI 兼容）
POST/openai/v1/images/edits圖生圖/圖片編輯（OpenAI 兼容）
POST/v1beta/models/{model}:generateContentGemini 圖片生成（Nano Banana 等）

音頻與視頻

方法路徑說明
POST/v1/synthesis語音合成（TTS）
POST/v1/videos視頻生成（Sora 兼容）
GET/v1/videos/{video_id}查詢視頻生成狀態
GET/v1/videos/{video_id}/content下載視頻結果

平臺

方法路徑說明
GET/v1/models列出可用模型
GET/openApi/queryModelBill查詢用量賬單（AccessKey 籤名鑑權）

💬Chat Completions

POST https://api.ai-leapx.com/v1/chat/completions

OpenAI 兼容的對話/多模態接口，支持文本生成、圖像理解、視頻理解、音頻處理、工具調用、流式輸出等能力。適用於 GPT、Claude、Gemini、DeepSeek、Qwen、豆包等幾乎所有模型。

典型應用：

入參參數

參數說明必填類型
model模型 ID必填String
messages聊天上下文信息（詳見下方 Messages 參數說明），包含從頭到尾的對話歷史必填Array
max_tokens本次請求返回的最大 Token 數（Claude 模型必填）可選Integer
temperature影響輸出多樣性，取值 [0.0, 2.0]。較高值更隨機，較低值更確定。模型有默認推薦值，不推薦修改。可選Float
top_p影響輸出多樣性，取值 [0.0, 1.0]。值越大多樣性越強。模型有默認推薦值，不推薦修改。可選Float
stream是否使用流式接口。true 流式 / false 非流式（默認 false）可選Boolean
思考參數各模型廠商思考參數不同，詳見下方 思考參數說明可選—

示例代碼（多模態 + 流式）

調用多模態模型描述圖片內容（流式輸出）：

cURL 
curl --location 'https://api.ai-leapx.com/v1/chat/completions' \
  --header "Authorization: Bearer API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "qwen-vl-max",
  "messages": [
    {
      "role": "system",
      "content": [{"type": "text", "text": "You are a helpful assistant."}]
    },
    {
      "role": "user",
      "content": [
        {
          "type": "image_url",
          "image_url": {
            "url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20241022/emyrja/dog_and_girl.jpeg"
          }
        },
        {"type": "text", "text": "圖中描繪的是什麼景象?"}
      ]
    }
  ],
  "stream": true
}'

返回參數

參數說明類型
createdUnix 時間戳（秒），示例：1705634032Integer
model模型 IDString
usageToken 統計：prompt_tokens / completion_tokens / total_tokens（按總 Token 計費）Object
choices回復內容列表（詳見下方 choices 說明）Array

choices 字段

通常只含一個元素（n=1 時），每個元素包含：

字段說明類型
index在 choices 中的索引，通常爲 0Integer
finish_reasonstop 自然停止 / length 達到最大 Token / content_filter 內容過濾 / tool_calls 工具調用String
message模型生成的消息，含 content / role / tool_callsObject
delta流式返回時的增量內容Object

返回示例

JSON 
{
  "choices": [
    {
      "delta": {
        "content": "這張圖片展示了一位女士和一隻狗在海灘上互動...",
        "role": "assistant"
      },
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null
    }
  ],
  "object": "chat.completion",
  "usage": {
    "prompt_tokens": 1270,
    "completion_tokens": 54,
    "total_tokens": 1324
  },
  "created": 1725948561,
  "model": "qwen-vl-max",
  "id": "chatcmpl-0fd66f46-b09e-9164-a84f-3ebbbedbac15"
}
JSON 
{
  "choices": [
    {
      "message": {
        "content": "這張圖片展示了一位女士和一隻狗在海灘上互動...",
        "role": "assistant"
      },
      "finish_reason": "stop",
      "index": 0,
      "logprobs": null
    }
  ],
  "object": "chat.completion",
  "usage": {
    "prompt_tokens": 1270,
    "completion_tokens": 54,
    "total_tokens": 1324
  },
  "created": 1725948561,
  "model": "qwen-vl-max",
  "id": "chatcmpl-0fd66f46-b09e-9164-a84f-3ebbbedbac15"
}

🧩Responses

POST https://api.ai-leapx.com/v1/responses

Responses API 是 OpenAI 最新推出的接口，原生支持高效的上下文管理，延續了 Chat API 的易用性，並提供模型的有狀態交互——將先前響應的輸出用作輸入。支持函數調用、MCP 調用等擴展能力。

前提條件：獲取 API Key、開通模型服務，僅支持 GPT 系列模型。相關指南可參閱 OpenAI 官網。

普通對話

cURL · 請求
curl --location --request POST 'https://api.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "model": "gpt-4o-mini",
    "input": "你好"
  }'
JSON · 響應
{
  "id": "resp_68b65ed1a3208191b78047adad685c8b0f24654d3ee42629",
  "object": "response",
  "status": "completed",
  "model": "gpt-4o-mini",
  "output": [
    {
      "id": "msg_...",
      "type": "message",
      "status": "completed",
      "content": [
        {"type": "output_text", "annotations": [], "text": "你好！有什麼我可以幫你的嗎？"}
      ],
      "role": "assistant"
    }
  ],
  "usage": {
    "input_tokens": 8,
    "output_tokens": 10,
    "total_tokens": 18
  },
  "created_at": 1756782289
}

圖片分析

cURL · 請求
curl --location --request POST 'https://api.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "input": [
      {
        "role": "user",
        "content": [
          {"type": "input_text", "text": "描述這張圖片中的內容"},
          {"type": "input_image", "image_url": "https://example.com/image_1.png"}
        ]
      }
    ],
    "stream": false,
    "model": "gpt-4o-mini"
  }'

流式響應

cURL · 請求
curl --location --request POST 'https://api.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "model": "gpt-4o-mini",
    "instructions": "你是一個有幫助的助手。",
    "input": "你好",
    "stream": true
  }'

SSE 事件序列：response.created → response.in_progress → response.output_item.added → response.output_text.delta（多次）→ response.output_text.done → response.content_part.done → response.output_item.done → response.completed。

函數調用

cURL · 請求
curl --location --request POST 'https://api.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "input": [{"content": "今天合肥的天氣怎麼樣", "role": "user"}],
    "stream": false,
    "model": "gpt-4o-mini",
    "tools": [
      {
        "name": "get_the_weather_info",
        "description": "get the weather info",
        "type": "function",
        "parameters": {
          "type": "object",
          "properties": {
            "city": {"description": "the city name", "type": "string"},
            "day":  {"description": "the day", "type": "string"}
          },
          "required": ["city"]
        }
      }
    ]
  }'

MCP 調用

cURL · 請求
curl --location --request POST 'https://api.ai-leapx.com/v1/responses' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer ${API_KEY}' \
  --data-raw '{
    "input": [{"content": "今天合肥的天氣怎麼樣", "role": "user"}],
    "model": "gpt-responses",
    "stream": false,
    "tools": [
      {
        "server_label": "amap",
        "require_approval": "never",
        "server_url": "https://mcp.amap.com/mcp?key=**************",
        "type": "mcp"
      }
    ]
  }'

📨Messages

POST https://api.ai-leapx.com/v1/messages

Anthropic Messages 協議。給定一組包含文本和/或圖像內容的結構化輸入消息列表，模型將生成對話中的下一條消息。Messages API 可用於單次查詢或無狀態的多輪對話。

支持模型：Claude 系列、MiniMax M2 系列、doubao-seed-code 系列、智譜 GLM 4.6 / 4.7 / GLM-5 旗艦系列。

鑑權方法

請求頭使用 x-api-key（注意：本接口與 Chat Completions 不同，不使用 Bearer Token）：

HTTP Header
x-api-key: ${API_KEY}
Content-Type: application/json

普通對話

cURL · 請求
curl --location --request POST 'https://api.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --data-raw '{
    "messages": [
      {
        "content": [{"type": "text", "text": "你好"}],
        "role": "user"
      }
    ],
    "model": "claude-sonnet-4-20250514"
  }'
JSON · 響應
{
  "id": "msg_bdrk_01SW8FrxLH2ZgFMpgvSvkUsk",
  "type": "message",
  "role": "assistant",
  "model": "claude-sonnet-4-20250514",
  "content": [
    {"type": "text", "text": "你好！很高興認識你。有什麼我可以幫助你的嗎？"}
  ],
  "usage": {
    "input_tokens": 10,
    "output_tokens": 29,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  },
  "stop_reason": "end_turn",
  "stop_sequence": null
}

圖片分析

cURL
curl --location --request POST 'https://api.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --data-raw '{
    "messages": [
      {
        "content": [
          {"text": "圖片描述的是什麼", "type": "text"},
          {
            "source": {
              "data": "/9j/4gIcSUNDX1BSTN+M/V0l7qkPTek...",
              "media_type": "image/jpeg",
              "type": "base64"
            },
            "type": "image"
          }
        ],
        "role": "user"
      }
    ],
    "model": "claude-sonnet-4-20250514"
  }'

流式響應

cURL
curl --location --request POST 'https://api.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --data-raw '{
    "stream": true,
    "messages": [{"content": [{"type": "text", "text": "你好"}], "role": "user"}],
    "model": "claude-sonnet-4-20250514"
  }'

SSE 事件序列：message_start → content_block_start → content_block_delta（多次）→ content_block_stop → message_delta → message_stop。

函數調用

cURL · 第一輪（模型決定調用工具）
curl --location --request POST 'https://api.ai-leapx.com/v1/messages' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: ${API_KEY}' \
  --data-raw '{
    "messages": [{"content": "今天合肥的天氣怎麼樣", "role": "user"}],
    "model": "claude-sonnet-4-20250514",
    "tools": [
      {
        "input_schema": {
          "type": "object",
          "properties": {
            "city": {"description": "the city name", "type": "string", "enum": []}
          }
        },
        "name": "get_the_weather_info",
        "description": "get the weather info"
      }
    ]
  }'

響應中 stop_reason 爲 "tool_use"，content 數組包含 type: "tool_use" 內容塊。客戶端執行工具後，將結果以 tool_result 形式回傳以完成第二輪。

請求體參數

參數類型必填說明
modelString必填要使用的模型名稱，1–256 字符。
messagesArray必填輸入消息列表（user / assistant 角色交替）。連續同角色消息會被合併。
max_tokensInteger必填生成的最大 token 數量，> 1。不同模型上限不同。
systemString可選系統 prompt。Messages API 中沒有 system role，系統提示通過頂層 system 字段提供。
temperatureNumber可選0.0 – 1.0，默認 1.0。分析任務建議接近 0，創造任務建議接近 1。
top_pNumber可選0 < x < 1。Nucleus 採樣。建議只調整 temperature 或 top_p 其中之一。
top_kInteger可選> 0。從 token 前 K 個選項中採樣。建議僅在高級場景使用。
streamBoolean可選是否使用 SSE 增量返回。
stop_sequencesArray可選自定義停止序列。
metadataObject可選請求元數據，含 user_id（不透明標識符，不要包含 PII，最大長度 256）。
thinkingObject可選擴展思考模式。{"type":"enabled","budget_tokens":2048} 啓用；{"type":"disabled"} 關閉。budget_tokens ≥ 1024 且小於 max_tokens。
tool_choiceObject可選工具選擇策略：auto/any/tool，可指定 disable_parallel_tool_use。
toolsArray可選工具定義列表，支持自定義工具 + 內置 Computer / Bash / TextEditor 工具。

內容塊類型

消息 content 可以是字符串，也可以是內容塊數組。支持的內容塊類型：

類型關鍵字段說明
texttext（最小長度 1）, cache_control文本內容
imagesource.type=base64, source.media_type, source.data圖片，支持 image/jpeg、png、gif、webp
tool_useid, name, input模型生成的工具調用
tool_resulttool_use_id, content, is_error客戶端回傳的工具執行結果
documentsource文檔輸入

響應體參數

字段類型說明
idString響應唯一標識符
typeString始終爲 "message"
roleString始終爲 "assistant"
modelString使用的模型名稱
contentArray由內容塊（text / tool_use）組成的輸出列表
stop_reasonString / nullend_turn / max_tokens / stop_sequence / tool_use
stop_sequenceString / null命中的自定義停止序列（如有）
usageObjectinput_tokens / output_tokens / cache_creation_input_tokens / cache_read_input_tokens

✨Gemini 原生

POST https://api.ai-leapx.com/v1beta/models/{model}:generateContent

Google Gemini API 是 Google 提供的大語言模型推理服務，支持文本生成、多模態理解、函數調用等能力。本文檔描述 Gemini API 的 REST 接口規範。

項目說明
Base URLhttps://api.ai-leapx.com/v1
API 版本v1beta
認證請求 URL 參數 ?key={API_KEY}
Content-Typeapplication/json

請求體（Request Body）

JSON · 結構
{
  "contents": [],
  "systemInstruction": {},
  "generationConfig": {},
  "safetySettings": [],
  "tools": [],
  "toolConfig": {},
  "cachedContent": ""
}
參數類型必填說明
contentsarray<Content>必填對話內容列表
systemInstructionContent可選系統指令
generationConfigGenerationConfig可選生成參數配置
safetySettingsarray<SafetySetting>可選安全過濾設置
toolsarray<Tool>可選工具/函數聲明
toolConfigToolConfig可選工具調用行爲配置
cachedContentstring可選緩存內容資源名稱

Content / Part 對象

Content 表示一條對話消息：role（user / model）和 parts（消息內容部分列表）。每個 Part 互斥地包含以下之一：

字段類型說明
textstring文本內容
inlineDataBlob內聯二進制數據（圖片/音頻/視頻等）。Blob: { mimeType, data (Base64) }
fileDataFileData通過 URI 引用的文件數據。FileData: { mimeType, fileUri }
functionCallFunctionCall模型返回的函數調用（僅 model 角色）。{ name, args }
functionResponseFunctionResponse用戶回傳的函數執行結果（僅 user 角色）。{ name, response }

GenerationConfig 對象

字段類型默認值說明
temperaturenumber模型默認控制隨機性，0.0–2.0
topPnumber模型默認核採樣概率閾值，0.0–1.0
topKinteger模型默認Top-K 採樣
candidateCountinteger1返回候選數量
maxOutputTokensinteger模型默認最大輸出 token 數
stopSequencesarray<string>無停止序列（最多 5 個）
presencePenaltynumber0.0存在懲罰
frequencyPenaltynumber0.0頻率懲罰
responseMimeTypestringtext/plain響應格式：text/plain / application/json
responseSchemaSchema無結構化輸出的 JSON Schema 定義
seedinteger無隨機種子
responseLogprobsbooleanfalse是否返回 token 對數概率
logprobsinteger無返回的 top log probabilities 數量
thinkingConfigThinkingConfig無思考模式配置（Gemini 2.5+ 支持）。thinkingBudget 0–24576；thinkingLevel（僅 Gemini 3 支持，與 thinkingBudget 互斥）。
audioTimestampbooleanfalse是否啓用音頻時間戳
mediaResolutionstring無媒體分辨率控制

SafetySetting 對象

每個 HarmCategory 最多設置一個：{ category, threshold }。

Tool / ToolConfig

工具通過 functionDeclarations 列表聲明，每項含 name / description / parameters（OpenAPI Schema 子集，type 取值 STRING / NUMBER / INTEGER / BOOLEAN / ARRAY / OBJECT）。

toolConfig.functionCallingConfig.mode：AUTO（默認）/ ANY（強制調用）/ NONE（禁止調用）。ANY 模式可通過 allowedFunctionNames 限制範圍。

基礎文本對話

cURL
curl -X POST \
  "https://api.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent?key=${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {"role": "user", "parts": [{"text": "你好，請介紹一下你自己"}]}
    ]
  }'

帶系統指令和生成配置

cURL
curl -X POST \
  "https://api.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent?key=${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "systemInstruction": {
      "parts": [{"text": "你是一個智能助手，回答簡潔友好。"}]
    },
    "contents": [
      {"role": "user", "parts": [{"text": "今天天氣怎麼樣？"}]}
    ],
    "generationConfig": {
      "temperature": 0.7,
      "topP": 0.95,
      "topK": 40,
      "maxOutputTokens": 1024
    },
    "safetySettings": [
      {"category": "HARM_CATEGORY_HARASSMENT", "threshold": "BLOCK_MEDIUM_AND_ABOVE"},
      {"category": "HARM_CATEGORY_DANGEROUS_CONTENT", "threshold": "BLOCK_MEDIUM_AND_ABOVE"}
    ]
  }'

多模態（圖片理解）

cURL · inlineData
curl -X POST \
  "https://api.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent?key=${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{
      "role": "user",
      "parts": [
        {"text": "描述這張圖片的內容"},
        {"inlineData": {"mimeType": "image/jpeg", "data": "BASE64_ENCODED_IMAGE_DATA"}}
      ]
    }]
  }'
大文件提示：大文件建議使用 GCS 存儲桶（fileData.fileUri 引用 gs://...），存儲桶必須設置爲公開可讀，否則返回 403 PERMISSION_DENIED。fileData 文件上限 2GB（gemini-2.0-flash 及以上）。

函數調用

cURL
curl -X POST \
  "https://api.ai-leapx.com/v1beta/models/gemini-2.5-flash:generateContent?key=${API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [{"role": "user", "parts": [{"text": "幫我打開微信"}]}],
    "tools": [{
      "functionDeclarations": [{
        "name": "launchApp",
        "description": "啓動指定的桌面應用程序",
        "parameters": {
          "type": "OBJECT",
          "properties": {"appName": {"type": "STRING", "description": "應用程序名稱"}},
          "required": ["appName"]
        }
      }]
    }],
    "toolConfig": {"functionCallingConfig": {"mode": "AUTO"}}
  }'

響應體（Response Body）

JSON
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [{"text": "模型回復內容"}]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {"category": "HARM_CATEGORY_HARASSMENT", "probability": "NEGLIGIBLE"}
      ]
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 10,
    "candidatesTokenCount": 50,
    "totalTokenCount": 60
  },
  "modelVersion": "gemini-2.5-flash"
}

FinishReason 枚舉：STOP / MAX_TOKENS / SAFETY / RECITATION / LANGUAGE / BLOCKLIST / PROHIBITED_CONTENT / FINISH_REASON_UNSPECIFIED。

HarmProbability 枚舉：NEGLIGIBLE / LOW / MEDIUM / HIGH。

流式生成（streamGenerateContent）

POST https://api.ai-leapx.com/v1beta/models/{model}:streamGenerateContent?alt=sse

請求體與 generateContent 完全相同。響應以 text/event-stream 格式返回，每個 data: 行是一個 JSON 片段：

SSE
data: {"candidates":[{"content":{"role":"model","parts":[{"text":"你"}]},"index":0}]}

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"好"}]},"index":0}]}

data: {"candidates":[{"content":{"role":"model","parts":[{"text":"！"}]},"finishReason":"STOP","index":0}],"usageMetadata":{"promptTokenCount":10,"candidatesTokenCount":3,"totalTokenCount":13}}

🖼️圖片生成 · OpenAI 兼容

POST https://api.ai-leapx.com/openai/v1/images/generations
POST https://api.ai-leapx.com/openai/v1/images/edits

兼容 OpenAI 協議標準，提供圖片生成（generations）和圖片編輯（edits）兩類能力。

注意：模型生成的圖片具有時效性，一般有效時長爲 1 小時，請及時保存到您自己的存儲系統中。

圖片生成 — 請求參數

參數說明必填類型
model模型名稱必填String
prompt圖片描述提示詞必填String
n生成圖片數量，1–10，默認 1可選Integer
size圖片尺寸（按模型不同有不同限制，詳見下文）可選String
quality圖像質量：DALL-E 支持 standard/hd；gpt-image-1 支持 low/medium/high/auto可選String
response_formaturl（默認）/ b64_json可選String
styleDALL-E 3 風格：natural / vivid（默認）可選String
其他參數模型特有參數，支持透傳（如 seed、guidance_scale 等）可選Any

size 取值參考：

示例代碼

cURL · 圖片生成
curl -X POST https://api.ai-leapx.com/openai/v1/images/generations \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "一條可愛的小狗在草地上奔跑",
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "response_format": "url",
    "style": "vivid"
  }'

返回參數

字段說明類型
createdUnix 時間戳（秒）Long
data生成的圖片列表List
data.revised_prompt模型修改後的提示詞String
data.url圖片 URL（response_format=url）String
data.b64_json圖片 Base64（response_format=b64_json）String
usage.input_tokens輸入 Token 總數（含 text_tokens / image_tokens 明細）Integer
usage.output_tokens輸出 Token 總數（含 text_tokens / image_tokens 明細）Integer
usage.total_tokensToken 總計Integer

圖片編輯（edits）

支持兩種請求格式：JSON 和 multipart/form-data（兼容 OpenAI 原廠 SDK 的文件上傳）。

方式一：JSON 請求

cURL · 圖片編輯（JSON）
curl -X POST https://api.ai-leapx.com/openai/v1/images/edits \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "在天空中添加一道彩虹",
    "image": ["https://example.com/original-image.png"],
    "n": 1,
    "size": "1024x1024",
    "response_format": "url"
  }'

方式二：multipart/form-data

cURL · 文件上傳
curl -X POST https://api.ai-leapx.com/openai/v1/images/edits \
  -H "Authorization: Bearer API_KEY" \
  -F "model=gpt-image-1" \
  -F "prompt=給人物添加一頂帽子" \
  -F "image[]=@/path/to/image1.png" \
  -F "image[]=@/path/to/image2.png" \
  -F "mask=@/path/to/mask.png" \
  -F "n=1" \
  -F "size=1024x1024"

額外參數透傳

除標準字段外，接口支持透傳模型特有的額外參數（如 seed、guidance_scale），在 JSON 請求體中直接添加即可。

🎨圖片生成 · Gemini 兼容

POST https://api.ai-leapx.com/v1beta/models/{model}:generateContent

當前接口僅支持 Gemini 系列圖片生成模型（如 Nano Banana / gemini-3-pro-image-preview-e）。imageConfig 控制分辨率：1K / 2K / 4K，aspectRatio 控制寬高比。

文生圖

cURL
curl --location --request POST \
  'https://api.ai-leapx.com/v1beta/models/gemini-3-pro-image-preview-e:generateContent?key=sk-xxxx' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer sk-xxxx' \
  --data-raw '{
    "contents": [
      {"role": "user", "parts": [{"text": "一條狗"}]}
    ],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }'

參考圖生圖

cURL
curl --location --request POST \
  'https://api.ai-leapx.com/v1beta/models/gemini-3-pro-image-preview-e:generateContent?key=sk-xxxx' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer sk-xxxx' \
  --data-raw '{
    "contents": [{
      "role": "user",
      "parts": [
        {"text": "畫條狗"},
        {"fileData": {"mimeType": "image/jpg", "fileUri": "https://cdn.pixabay.com/photo/.../tree-736885_1280.jpg"}}
      ]
    }],
    "generationConfig": {
      "responseModalities": ["TEXT", "IMAGE"],
      "imageConfig": {"aspectRatio": "16:9", "imageSize": "2K"}
    }
  }'

從返回結果的 candidates[].content.parts[] 中取出圖片的 Base64 數據：

JSON · 響應結構
{
  "candidates": [{
    "content": {"role": "...", "parts": [{}]},
    "finishReason": "...",
    "safetyRatings": [{}]
  }],
  "usageMetadata": {
    "promptTokenCount": 0,
    "candidatesTokenCount": 0,
    "totalTokenCount": 0
  }
}

🔊語音合成（TTS）

POST https://api.ai-leapx.com/v1/synthesis

語音合成（Text-to-Speech）將文本轉換爲自然語音，基於學習大量語音樣本掌握韻律、語調和發音規則，生成接近真人的語音。

應用場景

入參參數

參數說明必填類型
model模型 ID必填String
input合成參數對象必填JSON
input.text合成文本必填String
input.voice合成語音音色（在控制臺「開通管理 → 語音合成 → 我的音色」獲取）必填String

示例代碼

替換說明：示例中的 <YOUR_MODEL_ID> 與 <YOUR_VOICE_ID> 必須替換爲您賬號下實際開通的模型 ID 與音色 ID。模型 ID 通過 GET /v1/models（filter type=speech_model）獲取；音色 ID 在控制臺「開通管理 → 語音合成 → 我的音色」獲取。
cURL
curl -X POST https://api.ai-leapx.com/v1/synthesis \
  -H "Authorization: Bearer API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<YOUR_MODEL_ID>",
    "input": {
      "text": "那我來給大家推薦一款T恤，這款呢真的是超級好看。推薦寶寶們下單哦。",
      "voice": "<YOUR_VOICE_ID>"
    }
  }'

返回示例

JSON
{
  "code": 200,
  "msg": "語音合成成功",
  "data": {
    "url": "https://api.ai-leapx.com/63d8ba50b8da4f3d9d41131b99583fb3.mp3"
  }
}

🎬視頻生成（Sora 兼容）

POSThttps://api.ai-leapx.com/v1/videos
GEThttps://api.ai-leapx.com/v1/videos/{video_id}
GEThttps://api.ai-leapx.com/v1/videos/{video_id}/content
⚠️ 模型可用性：本接口遵循 OpenAI Sora API 規範。調用前請通過 GET /v1/models 查詢當前賬號下可用的視頻生成模型（type=visual_model），將下方示例中的 <YOUR_VIDEO_MODEL> 替換爲真實模型 ID 後再調用，否則可能返回"模型不可用"或"模型已下架"。

生成流程

  1. 創建任務：調用 POST /v1/videos，返回包含 id 和初始 status（queued / in_progress）的作業對象。
  2. 輪詢狀態：調用 GET /v1/videos/{video_id}，每 10–20 秒一次，必要時使用指數退避。任務狀態：queued / in_progress / completed / failed。注意：狀態記錄只保留 5 小時。
  3. 下載結果：狀態變爲 completed 後，調用 GET /v1/videos/{video_id}/content，端點會流式傳輸二進制 MP4 數據。下載鏈接生成後最多有效 1 小時，請立即保存到自有存儲。

創建視頻任務

Node.js · OpenAI SDK
import OpenAI from 'openai';

const openai = new OpenAI({
  apiKey: process.env.LEAPX_API_KEY,
  baseURL: 'https://api.ai-leapx.com/v1',
});

let video = await openai.videos.create({
  model: '<YOUR_VIDEO_MODEL>',
  prompt: "A video of the words 'Thank you' in sparkling letters",
});

console.log('Video generation started: ', video);
JSON · 響應
{
  "id": "video_68d7512d07848190b678d5",
  "object": "video",
  "created_at": 1758941485,
  "status": "queued",
  "model": "<YOUR_VIDEO_MODEL>",
  "progress": 0,
  "seconds": "8",
  "size": "1280x720"
}

使用圖像參考（首幀）

可以傳入參考圖作爲視頻的第一幀，用於保留品牌資產、角色或環境外觀。圖像分辨率必須與 size 匹配，支持 image/jpeg、image/png、image/webp。

cURL
curl -X POST "https://api.ai-leapx.com/v1/videos" \
  -H "Authorization: Bearer $LEAPX_API_KEY" \
  -H "Content-Type: multipart/form-data" \
  -F prompt="She turns around and smiles, then slowly walks out of the frame." \
  -F model="<YOUR_VIDEO_MODEL>" \
  -F size="1280x720" \
  -F seconds="8" \
  -F input_reference="@sample_720p.jpeg;type=image/jpeg"

Remix 已完成視頻

對現有視頻進行針對性調整，無需從頭重新生成。系統會在應用修改的同時重用原始視頻的結構、連貫性和構圖。最適合做單個、明確的更改。

cURL
curl -X POST "https://api.ai-leapx.com/v1/videos/<previous_video_id>/remix" \
  -H "Authorization: Bearer $LEAPX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "Shift the color palette to teal, sand, and rust, with a warm backlight."
  }'

📦模型列表

GET https://api.ai-leapx.com/v1/models

列出當前賬號可用的全部模型，包含每個模型的基本信息。

請求示例

cURL
curl --location --request GET 'https://api.ai-leapx.com/v1/models' \
  --header 'Content-Type: application/json' \
  --header "Authorization: Bearer API_KEY"

響應示例

JSON
{
  "object": "list",
  "data": [
    {
      "id": "model-id-0",
      "object": "model",
      "created": 1686935002,
      "owned_by": "LeapX",
      "type": "text_model"
    }
  ]
}

返回參數

字段說明類型
id模型標識符，可在 API 端點中引用String
object對象類型，固定爲 "model"String
createdUnix 時間戳（秒）Integer
owned_by模型所屬組織String
type模型類型，見下表String

type 取值：

🔑AccessKey 管理

AccessKey 是請求平臺 OpenAPI（如賬單接口）的憑證，與普通 API Key 不同。每個身份最多創建 5 對密鑰。

實踐建議

創建入口

登錄平臺後，訪問控制臺「AccessKey 管理」頁面獲取 Access Key ID 與 Secret Access Key。

💳獲取賬單接口

GET https://api.ai-leapx.com/openApi/queryModelBill

按時間區間查詢賬戶用量賬單。在 AccessKey 管理頁面獲取 Access Key ID 與 Secret Access Key，使用 AccessKey 籤名鑑權。

請求示例

cURL
curl -X GET "https://api.ai-leapx.com/openApi/queryModelBill?startDate=20251118&endDate=20260225" \
  --header 'X-Date: 20260227T035311Z' \
  --header 'X-Access-Key-Id: kjvXZNzdlDIoC******wBd9306S9d6KlcIKFOc1Jz4' \
  --header 'X-Signature: 0075105a5aa5bcccb37b0c73c211*******4a4589bd7a90c0b5d'

請求參數

參數說明必填類型
startDate賬單查詢開始時間，格式 YYYYMMDD必填String
endDate賬單查詢結束時間，格式 YYYYMMDD必填String
X-DateUTC 時間，精確到秒，ISO 8601 格式：YYYYMMDD'T'HHMMSS'Z'必填String
X-Access-Key-IdAccessKey 管理中獲取的 Access Key ID必填String
X-Signature方法籤名（使用 Secret Access Key 對請求計算）必填String
注意：單次查詢的開始時間與結束時間區間不得超過 100 天。籤名算法支持 Java / Python / JavaScript 等多語言示例，請在控制臺獲取。

響應字段

頂層包含用戶信息（nickName / accountId / accountType / phone / email）與賬單列表 modelBills。每條賬單含 billTime、orderNum、status（1 已結清 / 2 出賬中 / 3 欠費）以及 useInfo 用量明細。

每條 useInfo 含 apiKeyId / apiKeyName / totalPrice，以及多模型用量列表 modelDetails：modelName、model、serviceProvider、rateCardRate（刊例價）、totalPrice、modelAttribute（模型屬性同 type）、usage、usageUnit。

刊例價示例

👥企業子賬號管理

LeapX 支持企業子賬號共用，滿足團隊協作、企業主號付款的需求。

一、轉爲企業號

如您已經是企業號，可忽略此步驟。登錄賬號後點擊「個人中心 → 賬戶管理 → 轉爲企業號」，填寫信息即可。

二、子賬號管理

  1. 賬號創建：「個人中心 → 子賬號管理」按要求填寫子賬號信息；使用子賬號登錄地址登錄後綁定員工本人手機號。
  2. 用戶組添加：在「用戶組」可添加部門、團隊、子公司等用戶組。
  3. 角色管理：添加角色，目前只需對非默認菜單進行授權即可，模型廣場等默認菜單已默認展示。

🤖Hermes Agent 接入

Hermes Agent 配置使用 LeapX。詳細的圖文配置步驟請聯繫 LeapX 客服或參考控制臺「使用教程」頁。

關鍵配置：Base URL https://api.ai-leapx.com/v1，API Key 在控制臺「API Key 管理」獲取。

⌨️LeapX × Claude Code

使用 LeapX 平臺爲 Claude Code（Anthropic 官方 CLI）提供模型能力。詳細的圖文配置步驟請參考控制臺「使用教程」中的「平臺 X Claude Code」專題文檔。

核心配置：將 Claude Code 的 ANTHROPIC_BASE_URL 指向 https://api.ai-leapx.com/v1，ANTHROPIC_AUTH_TOKEN 設置爲您的 LeapX API Key，即可使用 LeapX 提供的 Claude 系列模型。

📝Cursor 中使用 Claude

前提條件

  1. 擁有一個 Cursor Pro 賬號（免費版只能短期試用 API 配置功能）。
  2. 在 ai-leapx.com 獲取 API Key，並確保已開通 Claude 系列的模型服務。
說明：由於 Cursor 對 Claude 模型路徑做正則匹配，model 名稱包含 "claude" 字樣會自動走 Anthropic 路徑。因此 LeapX 對 Claude 模型做了別名（例如 kld-o-4.6 對應 claude opus 4.6），方便在 Cursor 中調用。

Cursor 配置步驟

  1. 進入 Cursor 後臺「Settings → Models」，滑動頁面展開「API Keys」。
  2. 依次填寫：
    API Keys：LeapX 控制臺獲取的 API 密鑰
    Base URL：https://api.ai-leapx.com/v1 （務必填寫正確）
  3. 開啓 API Keys 開關，添加新模型，點擊 Verify 校驗。校驗時使用的模型必須是 LeapX 提供的可用模型。
  4. 在對話區選擇 ASK 模式 + 配置的模型，即可開始使用。

🧩在 Cline 中使用

安裝 Cline

在 VSCode 中搜索並安裝 Cline 插件。

打開 Cline 配置

在 VSCode 中通過 Ctrl/Command + Shift + P 打開命令工具，在新 tab 中打開 Cline 進行配置。

配置項

項目值
API Provider選擇 OpenAI Compatible
Base Urlhttps://api.ai-leapx.com/v1
API Key從 ai-leapx.com 控制臺獲取（參考快速開始）
Model ID從 ai-leapx.com 控制臺「開通管理」獲取

點擊 Let's Go 即可使用。

⚡在 Dify 使用海外高速 GPT

使用前可先在 ai-leapx.com 註冊賬號，新用戶可領 15 元代金券。

🎯 痛點解決：✅ 無需翻牆（告別 VPN 限制）  ✅ 免國際信用卡（支付寶/微信直接支付）  ✅ 即時調用全球優質模型

配置步驟

  1. 打開 Dify「Settings」。
  2. 選擇導航欄「Model Provider」，添加兼容 OpenAI 接口的模型插件（如 GPUSTACK）。
  3. 在插件中填寫：
    Model Name從 LeapX 控制臺「開通管理」獲取（OpenAI 插件只支持 GPT 系列）
    API KeyLeapX 控制臺獲取
    API 端點 URLhttps://api.ai-leapx.com/v1
  4. 設置完成後，可在模型列表中看到新增的模型。

📄WPS · OfficeAI 插件

一、安裝 OfficeAI 助手插件

  1. 訪問下載地址：office-ai.cn 下載頁
  2. 根據自身習慣進行安裝。

二、配置 WPS

  1. 打開文檔後選擇「文件 → 選項 → 信任中心」，勾選「啓用所有第三方 COM 加載項」，點擊確認。
  2. 確認後關閉 WPS 重啓，出現 OfficeAI 工具項。

三、設置 LeapX 大模型 API

點擊 OfficeAI → 設置 → 大模型 → 選擇「ApiKey」項，按以下任一方式添加配置：

方式一

APIURLhttps://api.ai-leapx.com/v1/chat/completions
API Key & 模型 ID從 ai-leapx.com 獲取

添加模型後點擊左側選擇即可出現。

方式二（兼容性更好）

點擊「新增服務商」，配置同上。注意：不要點擊"智能檢查"——智能檢查目前只對已集成到插件內的服務商有效。

配置完成後點擊 OfficeAI 插件，根據下方出現的工具欄使用相關功能，支持文檔、表格等。

🖼️在 Dify 中使用 LeapX 生成圖片

🎯 痛點解決：✅ 無需翻牆  ✅ 免國際信用卡  ✅ 即時調用全球優質模型

第一步：創建工具

  1. 打開 Dify 工作室，點擊「創建 → 工作流」，輸入自定義工作流名稱。
  2. 點擊創建後，點擊「設置 → 導入 DSL」，選擇 LeapX 提供的圖片生成工作流 DSL 文件導入。
  3. 發布工作流爲工具。

第二步：在 AI 應用中使用

創建自己的 AI 應用時，在編排頁面添加節點，選擇「工具」，選擇剛才發布的工作流工具；點擊節點進行工具參數設置即可使用。

🌐接入納米 AI

前提條件

需獲取 LeapX API Key，並確保已開通對應模型服務。由於納米 AI 的功能可能發生變化，模型的支持情況以實際效果為準。

配置步驟

  1. 搜索"納米 AI"，下載 PC 客戶端並安裝運行。
  2. 點擊「大模型」進入大模型使用頁面。
  3. 點擊「自定義模型」→「添加模型」。
  4. 按要求填寫參數。API 地址使用以 / 結尾的根路徑或完整路徑：
    根路徑https://api.ai-leapx.com/
    完整路徑https://api.ai-leapx.com/v1/chat/completions
  5. 點擊「檢測」，檢測通過後自動開啓。
  6. 回到大模型對話頁面，選擇配置好的模型即可體驗，可配合納米 AI 聯網搜索與知識庫使用。

🍒接入 Cherry Studio

前提條件

下載客戶端

訪問 cherry-ai.com/download，按客戶端版本下載並安裝。

客戶端配置

  1. 打開客戶端，點擊「設置 → 模型服務」，選擇 LeapX 服務商（如未內置，可選「OpenAI Compatible」自定義服務商）。
  2. 填寫 API Key 與 Base URL https://api.ai-leapx.com/v1。
  3. 點擊「管理」，獲取模型列表，添加可用模型。
  4. 點擊「助手」按鈕，選擇配置的服務商和模型，即可進行對話。

🧭瀏覽器插件 — Sider

  1. 安裝 Sider 插件：在 Sider 官方網站下載並添加到瀏覽器。
  2. 進入通用配置：選擇「OpenAI API key」，打開「使用我自己的網址」、「使用自定義模型名稱」。
  3. 獲取 LeapX URL 與 Key：在 LeapX 控制臺點擊「API Key」獲取 Key；點擊「開通管理」獲取 URL 與 Model ID。
  4. 配置 Sider：將 URL、Key 與模型 ID 填入即可使用。
    Base URLhttps://api.ai-leapx.com/v1

🔍瀏覽器插件 — Glarity

  1. 安裝 Glarity 插件：在 Glarity 官方網站下載並添加到瀏覽器。
  2. 進入通用配置：選擇「OpenAI API key」，打開「高級配置」。
  3. 填入 LeapX 配置：
    API KeyLeapX 控制臺獲取
    Base URLhttps://api.ai-leapx.com/v1
    ModelLeapX 控制臺「開通管理」獲取的 Model ID

🧠思考參數說明

各家模型廠商的思考（推理）參數不同，請按照所用模型選擇對應的參數配置。

OpenAI 系列
reasoning_effort String 默認：medium

僅適用於推理模型，約束推理工作量。減少推理工作可加快響應速度並減少 Token 消耗。

low medium high
Anthropic 系列（Claude）
thinking Object 默認：{"type":"disabled"}

配置 Claude 的擴展思考功能。啓用時響應包含思考過程內容塊。需要至少 1024 token 預算，並計入 max_tokens 限制，開啓思考時 max_tokens ≥ 1024。type 爲必填值，開啓思考時 budget_tokens 爲必填值。

JSON
// 開啓思考
"thinking": {"type": "enabled", "budget_tokens": 1024}

// 關閉思考
"thinking": {"type": "disabled"}
字節豆包 系列
thinking Object 默認：{"type":"enabled"}

type 爲必填字段。

enabled — 強制思考 disabled — 關閉思考 auto — 自動判斷
千問 / DeepSeek 系列
enable_thinking Boolean

開啓後思考內容通過 reasoning_content 字段返回。

true — 開啓 false — 關閉
谷歌 Gemini 系列
thinking_config Object

對於 Pro 版本，思考功能無法關閉。thinking_level 與 thinking_budget 不能同時存在（同時存在返回 400）。

JSON
// 開啓思考
"thinking_config": {"include_thoughts": true, "thinking_budget": 1024}

// 關閉思考
"thinking_config": {"include_thoughts": false, "thinking_budget": 0}

// Gemini 3 新參數（簡化級別，僅 Gemini 3 支持）
"thinking_config": {"thinking_level": "low"}

thinking_budget 取值範圍（Gemini 2.5）：

型號最低 Token最高 Token
Gemini 2.5 Flash124,576
Gemini 2.5 Pro12832,768
Gemini 2.5 Flash-Lite51224,576

參考：Google 官方文檔

💬Messages 參數說明（Chat Completions）

本章節描述 /v1/chat/completions 接口中 messages 數組的字段結構。每條消息屬於一個角色（Role），消息列表按對話順序排列。

system 系統消息（System Message）

用於告知模型角色或行爲。默認值爲 "You are a helpful assistant"。也可以將此類指令放在 user message 中，但放在 system message 中會更有效。

  • content必填 String — 系統消息內容
  • role必填 String — 固定爲 "system"
  • name可選 String — 對話參與者名稱
user 用戶消息（User Message）

用戶輸入給模型的內容。content 支持純文本或多模態數組（多模態數組僅多模態模型支持）。

  • role必填 String — 固定爲 "user"
  • content必填 String | Array — 文本或多模態內容數組
  • name可選 String — 對話參與者名稱
多模態內容類型
類型關鍵字段說明支持模型
texttype, text文本內容所有模型
image_urltype, image_url.url, image_url.detail圖片 URL 或 Base64多模態模型
video_urltype, video_url.url, videoMetadata / fps視頻內容。doubao 系列最大 50M；Gemini HTTP 網址最大 15MB；GCS 存儲桶 URI 最大 2GB（gemini-2.0-flash 及以上）Gemini、豆包
filetype, file.file_data, file.filename, file.file_type文件 Base64。亞馬遜廠商模型必傳 file_type，支持 pdf / csv / doc / docx / xls / xlsx / html / txt / md亞馬遜、谷歌雲
input_audiotype, input_audio.data, input_audio.format音頻 Base64 或谷歌存儲桶數據，例 audio/mp3Gemini
assistant 助手消息（Assistant Message）

模型的回覆；也可預填充作爲後續回復的示例。

  • content必填* String — 助手消息內容（指定 tool_calls 時除外）
  • role必填 String — 固定爲 "assistant"
  • name可選 String — 對話參與者名稱
  • tool_calls可選 Array — 模型生成的工具調用列表，每項含 id / type（僅支持 "function"）/ function（name + arguments）

📐返回格式化

OpenAI 系列 — response_format

對象類型，非必填，指定模型必須輸出的格式。

設置值效果
{"type": "json_schema", "json_schema": {...}}結構化輸出，模型輸出匹配指定 JSON Schema
{"type": "json_object"}JSON 模式，輸出爲合法 JSON
注意：使用 JSON 模式時，您必須通過 system 或 user 消息自行指示模型生成 JSON，否則模型可能會生成無盡的空白直到達到 token 限制。

谷歌 Gemini 系列

參數說明
response_mime_typetext/plain（默認）/ application/json / text/x.enum
response_schema非必填，指定輸出結構。需配合非 text/plain 的 MIME 類型使用

Schema 對象屬性：

屬性類型必需說明
type枚舉必填數據類型
description字符串可選字段描述
enum數組可選枚舉值列表（type 爲 string 時）
example任意可選示例值
nullable布爾可選是否可爲 null
format字符串可選字符串格式（如 date、date-time）
items對象可選數組項 Schema（type 爲 array 時）
properties對象可選對象屬性 Schema（type 爲 object 時）
required數組可選必需屬性名稱列表
minimum / maximum數字可選數字範圍
minItems / maxItems整數可選數組長度範圍
minLength / maxLength整數可選字符串長度範圍

⚠️錯誤碼

通用錯誤格式（OpenAI / 圖片接口）

JSON
{
  "error": {
    "message": "錯誤描述信息",
    "type": "錯誤類型",
    "code": null
  }
}

Gemini 錯誤格式

JSON
{
  "error": {
    "code": 400,
    "message": "錯誤描述信息",
    "status": "INVALID_ARGUMENT"
  }
}

常見錯誤碼

HTTPstatus說明
400INVALID_ARGUMENT請求參數錯誤
401UNAUTHENTICATEDAPI Key 無效或缺失
403PERMISSION_DENIED無權訪問該模型或功能（含 GCS 私有桶訪問拒絕等）
404NOT_FOUND模型不存在或已退役
429RESOURCE_EXHAUSTED超出速率限制 / 配額耗盡
500INTERNAL服務器內部錯誤 / 模型服務調用異常
503UNAVAILABLE服務暫時不可用