Send a list of messages containing modalities such as text, images, videos, and more. The model will generate the next message in the conversation.

• Base URL: For example, in the North China 2 (Beijing) region, the Base URL is: https://operator.las.ap-southeast-1.volces.com. When actually using the service, you need to use the Base URL for your current service region. For details, see Usage methods.
• Path：/api/v1/chat/completions
• Method: POST
• Content-type: application/json

Non-streaming response #

Streaming response #

Streaming output #

• request

  curl

  curl https://operator.las.ap-southeast-1.volces.com/api/v1/chat/completions      -H "Content-Type: application/json"      -H "Authorization: Bearer $ARK_API_KEY"      -d $'{
         "messages": [
             {
                 "content": "You are a helpful assistant.",
                 "role": "system"
             },
             {
                 "content": "hello",
                 "role": "user"
             }
         ],
         "model": "doubao-1-5-pro-32k-250115",
         "stream": true
     }'
  

• response

  curl

  {"choices":[{"delta":{"content":"Hello","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":"!","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":" How","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":" can","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":" I","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":" help","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":" you","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":" today","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":"?","role":"assistant"},"index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     {"choices":[{"delta":{"content":"","role":"assistant"},"finish_reason":"stop","index":0}],"created":1742632436,"id":"021742632435712396f12d018b5d576a7a55349c2eba0815061fc","model":"doubao-1-5-pro-32k-250115","service_tier":"default","object":"chat.completion.chunk","usage":null}
     
     [DONE]
  

Continuation mode #

• request

  curl

  curl https://operator.las.ap-southeast-1.volces.com//api/v1/chat/completions      -H "Content-Type: application/json"      -H "Authorization: Bearer $ARK_API_KEY"      -d $'{
         "messages": [
             {
                 "content": "你是一个计算器，请计算： 1 + 1",
                 "role": "user"
             },
             {
                 "content": "=",
                 "role": "assistant"
             }
         ],
         "model": "doubao-1-5-pro-32k-250115"
     }'
  

• response

  curl

  {
       "choices": [
         {
           "finish_reason": "stop",
           "index": 0,
           "logprobs": null,
           "message": {
             "content": " 2",
             "role": "assistant"
           }
         }
       ],
       "created": 1742634165,
       "id": "0217426341647344ee2a242cadeb3c7acc981f0bd805884bc65fc",
       "model": "doubao-1-5-pro-32k-250115",
       "service_tier": "default",
       "object": "chat.completion",
       "usage": {
         "completion_tokens": 2,
         "prompt_tokens": 21,
         "total_tokens": 23,
         "prompt_tokens_details": {
           "cached_tokens": 0
         },
         "completion_tokens_details": {
           "reasoning_tokens": 0
         }
       }
     }
  

Image understanding #

• request

  curl

  curl https://operator.las.ap-southeast-1.volces.com//api/v1/chat/completions      -H "Content-Type: application/json"      -H "Authorization: Bearer $ARK_API_KEY"      -d $'{
         "model": "doubao-1-5-vision-pro-32k-250115",
         "messages": [
             {
                 "content": [
                     {
                         "image_url": {
                             "url": "https://ark-project.tos-cn-beijing.volces.com/images/view.jpeg"
                         },
                         "type": "image_url"
                     },
                     {
                         "text": "图片主要讲了什么?",
                         "type": "text"
                     }
                 ],
                 "role": "user"
             }
         ]
     }'
  

• response

  curl

  {
       "choices": [
         {
           "finish_reason": "stop",
           "index": 0,
           "logprobs": null,
           "message": {
             "content": "画面中呈现了一幅宁静的户外景象。一个人乘坐在橙黄色的皮划艇上，手持船桨，正在平静的水面划行。水面如镜，倒映着周围景致。远处是茂密的森林，森林后方矗立着巍峨的雪山，山体覆盖着白雪。天空呈浅蓝色，飘浮着一些云朵。整体氛围静谧而美好，展现出自然的纯净与壮阔。 ",
             "role": "assistant"
           }
         }
       ],
       "created": 1742636149,
       "id": "0217426361458116592a076493be583bc5e33f80ac2dcf1efc31b",
       "model": "doubao-1-5-vision-pro-32k-250115",
       "service_tier": "default",
       "object": "chat.completion",
       "usage": {
         "completion_tokens": 85,
         "prompt_tokens": 521,
         "total_tokens": 606,
         "prompt_tokens_details": {
           "cached_tokens": 0
         },
         "completion_tokens_details": {
           "reasoning_tokens": 0
         }
       }
     }
  

Deep reasoning #

• request

  curl

  curl https://operator.las.ap-southeast-1.volces.com//api/v1/chat/completions      -H "Content-Type: application/json"      -H "Authorization: Bearer $ARK_API_KEY"      -d $'{
         "messages": [
     
             {
                 "content": "我要有研究推理模型与非推理模型区别的课题，怎么体现我的专业性",
                 "role": "user"
             }
         ],
         "model": "doubao-seed-1-6-251015"
     }'
  

• response

  curl

  {
       "choices": [
         {
           "finish_reason": "stop",
           "index": 0,
           "logprobs": null,
           "message": {
             "content": "
  
  推理模型与非推理模型的主要区别在于其处理任务的方式、能力侧重点以及应用场景。以下是两者的核心区别分析：
  
  ---
  
  ### **1. 核心定义**
  - **推理模型**  
    具备**逻辑推理、因果推断或复杂决策**能力，***  
  
  实际应用中，两类模型常配合使用（如用非推理模型提取特征，再交给推理模型决策），以平衡效率与准确性。",
             "reasoning_content": "嗯，用户问的是推理模型和非推理模型有什么区别。我需要先理解这两个术语的具体含义。可能用户对机器学习或深度学习有一定的了解，但需要更清晰的区分。首先，我应该明确这两个概念的定义，然后从不同角度进行比较。
  
  首先，推理模型可能指的是那些需要进行逻辑推理、处理复杂任务的模型，***，而非推理模型侧重于模式识别和直接映射，帮助用户形成清晰的概念框架。
  ",
             "role": "assistant"
           }
         }
       ],
       "created": 1742636537,
       "id": "0217426364949596592a076493be583bc5e33f80ac2dcf1eeaf9b",
       "model": "doubao-seed-1-6-251015",
       "service_tier": "default",
       "object": "chat.completion",
       "usage": {
         "completion_tokens": 1207,
         "prompt_tokens": 11,
         "total_tokens": 1218,
         "prompt_tokens_details": {
           "cached_tokens": 0
         },
         "completion_tokens_details": {
           "reasoning_tokens": 419
         }
       }
     }