接口详情

http调用

请求方式：POST

请求路径：https://ai.ctaigw.cn/v1/chat/completions

请求头

请求参数

非流式响应参数

流式响应参数

请求/响应示例

文本生成请求

curl -X POST https://ai.ctaigw.cn/v1/chat/completions \
-H "Authorization: Bearer ${YOUR_APP_KEY}" \
-H "Content-Type: application/json" \
-d '{
    "model": "qwen3.7-max",
    "messages": [
        {
            "role": "system",
            "content": "You are a helpful assistant."
        },
        {
            "role": "user",
            "content": "简单介绍向量数据库的用途"
        }
    ]
}'

多模态请求

curl -X POST https://ai.ctaigw.cn/v1/chat/completions \
-H "Authorization: Bearer ${YOUR_APP_KEY}" \
-H 'Content-Type: application/json' \
-d '{
 "model": "Qwen3-Omni-Flash",
    "messages": [
        {
            "role": "user",
            "content": [
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://aaaa.ctyun.cn/pic/01.jpeg"
                    }
                },
                {
                    "type": "text",
                    "text": "这是什么"
                }
            ]
        }
    ]
}'

非流式响应

{
    "choices": [
        {
            "message": {
                "role": "assistant",
                "content": "向量数据库主要用于存储向量嵌入，支持相似度检索。"
            },
            "finish_reason": "stop",
            "index": 0
        }
    ],
    "object": "chat.completion",
    "usage": {
        "prompt_tokens": 1000,
        "completion_tokens": 200,
        "total_tokens":1200,
        "prompt_tokens_details": {
            "cached_tokens": 600
        }
    },
    "created": 1735122033,
    "model": "qwen3.7-max",
    "id": "chatcmpl‑xxxx‑xxxx‑xxxx‑xxxxxxxx"
}

流式响应

{
  "id": "chatcmpl‑xxxx‑xxxx‑xxxx‑xxxxxxxx",
  "object": "chat.completion.chunk",
  "created": 1735122033,
  "model": "qwen3.7-max",
  "choices": [
    {
      "index": 0,
      "delta": {
        "content": "向量数据库主要用于存储向量嵌入，支持相似度检索",
        "role": assistant
      },
      "finish_reason": null
    }
  ]
}

异常响应示例

{
    "error": {
        "type:": "Invalid_request",
        "code": "missing_parameter",
        "message": "Missing required parameters"
    }
}