API 参考
API 概览
AsterMesh 的对话接口、Sora 兼容视频接口、鉴权方式和请求地址概览。
AsterMesh 的目标是让你用统一账号访问 Claude、Gemini、OpenAI、DeepSeek 等模型。大多数客户端只需要把官方接口地址替换为 AsterMesh 的 Base URL。
Base URL
OpenAI 兼容客户端和 Sora 兼容视频接口：
https://console.astermesh.cn/v1视频生成使用上传素材、创建任务、查询状态和下载内容的流程，完整示例见 视频生成。
Claude Code 或 Anthropic 兼容客户端：
https://console.astermesh.cnGemini 原生协议客户端如果支持自定义 endpoint，通常会要求填写 Gemini 兼容地址。实际路径以控制台或客户端说明为准；如果客户端支持 OpenAI-compatible，优先使用 https://console.astermesh.cn/v1。
鉴权
对话和视频接口使用 API Key 鉴权：
Authorization: Bearer YOUR_API_KEY常见 JSON 请求头：
Content-Type: application/json常见接口
| 接口 | 用途 |
|---|---|
GET /v1/models | 获取可用模型列表 |
POST /v1/chat/completions | OpenAI Chat Completions 兼容接口 |
POST /v1/responses | OpenAI Responses 兼容接口，适合新版工具和 Codex |
POST /v1/messages | Anthropic Messages 兼容接口 |
POST /v1/files | 上传视频生成所需的参考素材 |
POST /v1/videos | 创建视频生成任务 |
GET /v1/videos/{task_id} | 查询视频任务状态 |
GET /v1/videos/{task_id}/content | 下载已完成的视频 |
三个对话接口都支持在请求体里加 stream: true 逐字接收回复，见 流式输出。
视频生成采用异步任务流程，创建后需查询任务，等待 status 为 completed 再下载。上传参考素材使用表单请求；创建视频任务使用 JSON，见 视频生成。
最小 curl 示例
curl https://console.astermesh.cn/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "MODEL_ID",
"messages": [
{
"role": "user",
"content": "你好，介绍一下你自己。"
}
]
}'响应格式
OpenAI 兼容对话接口会尽量返回 OpenAI 风格的 JSON。常见字段包括：
idobjectcreatedmodelchoicesusage
不同模型提供商的字段可能略有差异。业务代码不要强依赖某个非标准字段。
视频接口按阶段返回上传结果、任务信息或视频内容。先保存上传得到的文件 URL 和创建任务得到的任务编号，再查询状态和下载，具体步骤见 视频生成。
错误格式
常见错误会包含状态码和错误信息，例如：
{
"error": {
"message": "Invalid API key",
"type": "invalid_request_error",
"code": "invalid_api_key"
}
}排查时优先看 HTTP 状态码，再看 message 和 code。