文本生成消息
发送消息
适用于：文本生成应用。
向文本生成型应用发送请求并返回生成的文本。
POST
/
completion-messages
curl --request POST \
--url https://{api_base_url}/completion-messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"inputs": {
"city": "New York"
},
"query": "Summarize the following text: ...",
"response_mode": "blocking",
"user": "def-456"
}
'{
"answer": "Hello World!...",
"created_at": 1705407629,
"event": "message",
"id": "b01a39de-3480-4f3e-9f1e-4841a80f8e5e",
"message_id": "9da23599-e713-473b-982c-4328d4f5c78a",
"metadata": {
"usage": {
"completion_price": "0.0002560",
"completion_price_unit": "0.001",
"completion_tokens": 128,
"completion_unit_price": "0.002",
"currency": "USD",
"latency": 0.7682376249867957,
"prompt_price": "0.0010330",
"prompt_price_unit": "0.001",
"prompt_tokens": 1033,
"prompt_unit_price": "0.001",
"total_price": "0.0012890",
"total_tokens": 1161
}
},
"mode": "completion",
"task_id": "c3800678-a077-43df-a102-53f23ed20b88"
}Authorizations
Body
application/json
创建文本生成消息的请求体。
要处理的文本。旧版字段；较新的应用改为在 inputs 中传递。
响应返回模式。streaming（推荐）使用 SSE。blocking 等待完成后返回（长时间处理可能会被中断）。Cloudflare 超时为 100 s。省略时默认为阻塞模式。
Available options:
streaming, blocking Response
请求成功。内容类型和结构取决于请求中的 response_mode 参数。
- 如果
response_mode为blocking，返回application/json和CompletionResponse对象。 - 如果
response_mode为streaming，返回text/event-stream和ChunkCompletionEvent对象流。
完整的响应内容。
消息创建时间戳（Unix 纪元秒）。
事件类型，固定为 message。
该响应事件的唯一 ID。
唯一的消息 ID。调用反馈或推荐问题接口时，将此值作为 message_id 参数使用。
包含用量和检索资源的元数据。
Show child attributes
Show child attributes
应用模式，固定为 completion。
Last modified on September 30, 2026
Was this page helpful?
⌘I
curl --request POST \
--url https://{api_base_url}/completion-messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"inputs": {
"city": "New York"
},
"query": "Summarize the following text: ...",
"response_mode": "blocking",
"user": "def-456"
}
'{
"answer": "Hello World!...",
"created_at": 1705407629,
"event": "message",
"id": "b01a39de-3480-4f3e-9f1e-4841a80f8e5e",
"message_id": "9da23599-e713-473b-982c-4328d4f5c78a",
"metadata": {
"usage": {
"completion_price": "0.0002560",
"completion_price_unit": "0.001",
"completion_tokens": 128,
"completion_unit_price": "0.002",
"currency": "USD",
"latency": 0.7682376249867957,
"prompt_price": "0.0010330",
"prompt_price_unit": "0.001",
"prompt_tokens": 1033,
"prompt_unit_price": "0.001",
"total_price": "0.0012890",
"total_tokens": 1161
}
},
"mode": "completion",
"task_id": "c3800678-a077-43df-a102-53f23ed20b88"
}