API 快速入门指南 - simeng.ai Docs

可用模型与在线体验

在模型市场页面浏览我们完整的 AI 模型目录。每个模型都配有在线试用功能，您可以在编写代码前体验提示词和参数的效果。

100+ 模型，涵盖视频、图像、音乐和大语言模型类别
免费沙盒环境用于测试，无需信用卡
在线预览模型输出效果

定价方式

我们采用灵活的积分计费系统。每次请求根据所用模型和参数消耗相应积分。我们的定价通常比直接调用模型提供商低 30%-50%。请访问定价页面查看每个模型的积分消耗详情。

创建和保护您的 API Key

在控制面板中生成您的 API Key。每个 Key 可以限定到特定模型和速率，以增强安全性。

安全要求

切勿在客户端代码或公开仓库中暴露您的 API Key。请始终使用环境变量或后端代理来保护密钥安全。

必需的请求头

所有 API 请求必须包含以下请求头，用于身份验证和内容协商。

HTTP Headers

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

异步任务模型

大多数生成任务（视频、图像、音乐）采用异步处理。提交请求后，您会立即收到一个 task_id。使用此 ID 轮询状态，或配置 Webhook 回调，在任务完成时接收通知。

状态验证

在尝试访问结果 URL 之前，请务必验证任务状态。任务可能仍在处理中或已失败。使用「获取任务详情」接口进行检查。

JSON Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "abc123-def456-ghi789",
    "status": "processing",
    "progress": 45,
    "result_url": null,
    "created_at": "2025-01-01T00:00:00Z"
  }
}

速率限制与并发

默认速率限制为每分钟 60 次请求和 5 个并发任务。企业账户可申请更高限额。超出速率限制时，API 返回 429 状态码。请在重试逻辑中实现指数退避策略。

开发者支持

加入我们的 Discord 或 Telegram 社区获取实时开发者支持。如需企业咨询，请通过控制面板直接联系我们的销售团队。