对话(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

必需

string

必需

model

string

必需

object

string

必需

usage

object

必需

completion_tokens

integer

必需

prompt_tokens

integer

必需

total_tokens

integer

必需

prompt_tokens_details

object

必需

修改于 2025-02-28 07:04:11

对话(Chat)-文本 API

创建视频生成任务 API