跳转到主要内容
AGICTO API 支持 OpenAI 兼容格式。你可以复用现有 OpenAI SDK、请求体结构和多数调用流程，只需要把 Base URL、API Key 和模型名切换到 AGICTO API。

​
迁移清单

项目OpenAIAGICTO API
Base URLhttps://api.openai.com/v1https://api.agicto.cn/v1
API KeyOpenAI API KeyAGICTO API Key
HeaderAuthorization: Bearer $API_KEYAuthorization: Bearer $API_KEY
请求格式OpenAI 格式OpenAI 兼容格式
如果你的 SDK 支持自定义 baseURL 或 base_url，优先用 SDK 接入。这样可以保留已有的重试、类型和流式处理逻辑。

​
Chat completions

使用 /v1/chat/completions 生成对话回复、摘要、翻译、分类和代码。 
curl https://api.agicto.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {
        "role": "user",
        "content": "请用三点总结这段文本。"
      }
    ]
  }'
查看接口细节：Chat completions

​
Embeddings

使用 /v1/embeddings 将文本转换为向量。常见用途包括语义搜索、推荐、聚类和 RAG 检索。 
curl https://api.agicto.cn/v1/embeddings \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "text-embedding-ada-002",
    "input": "AGICTO API supports OpenAI-compatible requests.",
    "encoding_format": "float"
  }'
查看接口细节：创建嵌入

​
Images

使用 /v1/images/generations 生成图片。你可以按模型能力传入 prompt、size 等参数。 
curl https://api.agicto.cn/v1/images/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "gpt-image-1",
    "prompt": "A clean product illustration for an API dashboard",
    "size": "1024x1024"
  }'
查看接口细节：图片生成

​
Videos

使用 /v1/videos 创建 OpenAI 兼容格式的视频任务。创建任务后，使用返回的 id 查询状态。 
curl https://api.agicto.cn/v1/videos \
  -H "Authorization: Bearer $API_KEY" \
  -F "model=sora-2-vip" \
  -F "prompt=一只机械手臂在实验室中组装芯片，电影感镜头" \
  -F "seconds=8" \
  -F "size=1280x720"
查看接口细节：视频任务流程

​
常见迁移问题

  • 如果返回认证错误，确认 Header 是 Authorization: Bearer $API_KEY。
  • 如果返回模型不可用，确认 model 是你账户支持的模型名。
  • 如果 OpenAI SDK 报路径错误，确认 Base URL 是否包含 /v1。
  • 如果请求图片或视频，确认你的请求格式是 JSON 还是 multipart/form-data。