快速开始

适用场景

这部分适合第一次接入心宝 AI 的开发者。建议先读完这里，再进入具体能力页。

接入前准备

1. 获取当前渠道可用的 API Key
2. 确认使用的 Base URL
3. 根据业务能力选择对应接口
4. 为图片或视频输入准备公网可访问的 URL

核心规则

• 所有接口统一使用 Authorization: Bearer <API_KEY>
• 请求体统一使用 JSON，建议显式使用 UTF-8
• 图像生成和视频生成都可能依赖公网图片 URL
• 视频任务默认是异步流程，需要提交任务后轮询结果

第一个请求

推荐先从图像生成能力开始验证链路：

curl -X POST "https://xinbaoapi.dpdns.org/v1beta/models/gemini-3-pro-image-preview:generateContent" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "contents": [
      {
        "role": "user",
        "parts": [
          { "text": "生成一张简洁的产品海报，背景干净，光线自然。" }
        ]
      }
    ],
    "generationConfig": {
      "responseModalities": ["IMAGE"]
    }
  }'

常见错误

• 401/403：通常是 API Key 无效或未按 Bearer 格式传递
• 404：接口路径或模型名不正确
• 400：参数结构不符合能力要求，例如把图片字段写错位置
• 视频任务长时间处理中：先检查轮询间隔是否过短或输入资源是否不可访问

下一步

• 鉴权
• Base URL
• 图像生成总览
• 视频生成总览