DeepSeek API 文檔介紹提供 DeepSeek API 文檔有語(yǔ)言選擇包括 English 和中文中國(guó)還有 DeepSeek 平臺(tái)相關(guān)內(nèi)容如快速開(kāi)始、API 指南、API 參考、新聞、其他資源、常見(jiàn)問(wèn)題解答、更新日志等。視覺(jué)模型特點(diǎn)‘deepseek - v4 - flash - vision - exp’ 模型支持同時(shí)接收?qǐng)D像和文本可描述圖片、讀取截圖文本、分析圖表等。支持的圖像格式有 JPEG、PNG、GIF 和 WebP系統(tǒng)根據(jù)文件實(shí)際內(nèi)容識(shí)別圖像格式。發(fā)送圖像的方式有三種向模型提供圖像的方式均采用與 OpenAI 兼容的聊天補(bǔ)全格式‘content’ 是數(shù)據(jù)塊數(shù)組。同樣適用于響應(yīng) API圖像包含在 ‘input_image’ 內(nèi)容部分。1. Base64 編碼的圖像內(nèi)聯(lián)將圖像編碼以 ‘data:’ URL 形式嵌入請(qǐng)求適合本地文件。編碼后數(shù)據(jù)會(huì)計(jì)入 48 MiB 的請(qǐng)求體大小限制。給出了 Python 和 bash 代碼示例。2. 外部圖像 URL傳遞可公開(kāi)訪問(wèn)的 ‘http(s)’ 鏈接模型自動(dòng)下載圖像。URL 長(zhǎng)度最多 8192 個(gè)字符圖像文件大小最多 32 MiB下載須在 60 秒內(nèi)完成。過(guò)長(zhǎng)鏈接建議用 Base64 數(shù)據(jù) URL 或文件 API并給出 Python 代碼示例。3. 引用通過(guò)文件 API 上傳的文件使用文件 API 上傳圖像在請(qǐng)求中引用其 ‘file_id’。適用于多次使用同一圖像或請(qǐng)求體超 48 MiB 限制的情況。通過(guò)文件 API ‘file_id’ 引用的圖像大小最大可達(dá) 64 MiB不受單張圖像 32 MiB 大小限制。給出了使用 ‘file_id’ 和 ‘file_data’ 的代碼示例。細(xì)節(jié)級(jí)別設(shè)置對(duì)于 ‘image_url’ 輸入可設(shè)置 ‘detail’ 字段控制圖像處理方式有 ‘low’、‘high’、‘original’、‘a(chǎn)uto’ 四種值并給出了 JSON 代碼示例。何時(shí)使用文件 API內(nèi)聯(lián)圖像會(huì)計(jì)入 48 MiB 的請(qǐng)求體大小限制以下情況建議使用文件 API單個(gè)請(qǐng)求超出請(qǐng)求體大小限制圖像大小超過(guò) 32 MiB需要在多個(gè)請(qǐng)求中引用同一圖像并避免重復(fù)上傳。令牌使用規(guī)則圖像根據(jù)尺寸轉(zhuǎn)換為令牌與文本令牌一起計(jì)費(fèi)。推理前每張圖像自動(dòng)調(diào)整大小總像素?cái)?shù)低于約 384×384 的圖像放大較大圖像縮小使總像素?cái)?shù)約為 800×800 圖像的像素?cái)?shù)。每張圖像的令牌上限為 384 個(gè)多圖像請(qǐng)求中每張圖像獨(dú)立計(jì)算?？墒褂昧钆婆c令牌使用頁(yè)面上的圖像令牌計(jì)算器估算特定尺寸圖像的令牌成本。限制條件包括支持的格式JPEG、PNG、GIF、WebP、外部 URL 長(zhǎng)度8192 個(gè)字符、請(qǐng)求體大小48 MiB、最大單張圖像大小Base64 / 外部 URL 為 32 MiB文件 API ‘file_id’ 為 64 MiB、每個(gè)請(qǐng)求的最大圖像數(shù)量600、每個(gè)請(qǐng)求的最大圖像總大小不包含 ‘file_id’ 圖像時(shí)為 64 MiB包含時(shí)最大可達(dá) 200 MiB、最大圖像尺寸每邊 8192 像素請(qǐng)求包含 15 張或更多圖像時(shí)每邊降至 4096 像素。有關(guān)文件 API 上傳文件的存儲(chǔ)和上傳配額參閱文件 API限制。還有其他限制條件僅 ‘user’ 消息支持包含圖像‘system’ 或 ‘a(chǎn)ssistant’ 消息包含圖像會(huì)返回 400 錯(cuò)誤只有視覺(jué)模型‘deepseek - v4 - flash - vision - exp’支持接收?qǐng)D像其他模型返回 400 錯(cuò)誤用戶文本中包含保留的圖像占位符令牌會(huì)被拒絕并返回 400 錯(cuò)誤。通過(guò) Anthropic API 使用圖像除與 OpenAI 兼容的端點(diǎn)外還可通過(guò)與 Anthropic 兼容的 ‘/messages’ 端點(diǎn)發(fā)送圖像。Anthropic 使用 ‘image’ 塊‘source’ 對(duì)象的 ‘type’ 可以是 ‘base64’、‘url’ 或 ‘file’并給出了 Python 代碼示例。三種 ‘source’ 類(lèi)型與 OpenAI 方法對(duì)應(yīng)各有注意事項(xiàng)。通過(guò)響應(yīng) API 使用圖像‘deepseek - v4 - flash - vision - exp’ 模型支持通過(guò)與 OpenAI 兼容的響應(yīng) API 接收?qǐng)D像適用三種輸入方法和相同限制僅內(nèi)容部分格式不同圖像包含在 ‘input_image’ 部分?！甶nput_image’ 部分支持 ‘detail’ 字段通過(guò) ‘file_id’ 提供圖像時(shí)‘detail’ 字段忽略‘image_url’ 和 ‘file_id’ 互斥。有關(guān)字段語(yǔ)義、限制條件和工具輸出圖像的詳細(xì)信息參閱響應(yīng) API 指南。