豆包 API(火山方舟)
  1. 对话(Chat) API
豆包 API(火山方舟)
  • 快速入门-调用模型服务
  • 介绍
    • 签名鉴权方式
    • 返回结构
    • 公共错误码
    • API 列表
    • 地域和访问域名
  • 对话(Chat) API
    • 对话(Chat)-文本 API
      POST
    • 对话(Chat)-视觉 API
      POST
  • 视频生成 API
    • 创建视频生成任务 API
      POST
    • 查询视频生成任务信息 API
      GET
    • 查询内容生成任务列表 API
      GET
    • 取消或删除内容生成任务
      DELETE
  • 向量化 API
    • 文本向量化 API
      POST
    • 未命名接口
      POST
  1. 对话(Chat) API

对话(Chat)-视觉 API

POST
https://ark.cn-beijing.volces.com/api/v3/chat/completions
本文介绍Doubao多模态大模型API的输入输出参数,方便您调用接口ChatCompletions,向大模型发起视觉理解的请求。模型会依据传入的图片信息以及问题,给出回复。
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://ark.cn-beijing.volces.com/api/v3/chat/completions' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data-raw '{
        "model": "doubao-vision-pro-32k-2410128",
        "messages": [
            {
                "role": "user",
                "content": [
                    {
                        "type": "text",
                        "text": "图片主要讲了什么?"
                    },
                    {
                        "type": "image_url",
                        "image_url": {
                            "url": "https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg"
                        }
                    },
                    {
                        "type": "image_url",
                        "image_url": {
                            "url": "https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a81e3cdd3e30617ecd524a132fdb2736.png"
                        }
                    }
                ]
            }
        ]
    }'
响应示例响应示例
{
    "choices": [
        {
            "finish_reason": "string",
            "index": 0,
            "logprobs": null,
            "message": {
                "content": "string",
                "role": "string"
            }
        }
    ],
    "created": 0,
    "id": "string",
    "model": "string",
    "object": "string",
    "usage": {
        "completion_tokens": 0,
        "prompt_tokens": 0,
        "total_tokens": 0,
        "prompt_tokens_details": {
            "cached_tokens": 0
        }
    }
}

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Header 参数
Content-Type
string 
必需
示例值:
application/json
Authorization
string 
必需
示例值:
Bearer {{ARK_API_KEY}}
Body 参数application/json
model
string 
必需
messages
array [object {2}] 
必需
role
string 
可选
content
array [object {3}] 
可选
示例

返回响应

🟢200成功
application/json
Body
choices
array [object {4}] 
必需
finish_reason
string 
可选
index
integer 
可选
logprobs
null 
可选
message
object 
可选
created
integer 
必需
id
string 
必需
model
string 
必需
object
string 
必需
usage
object 
必需
completion_tokens
integer 
必需
prompt_tokens
integer 
必需
total_tokens
integer 
必需
prompt_tokens_details
object 
必需
上一页
对话(Chat)-文本 API
下一页
创建视频生成任务 API
Built with