API集成指南

本指南将引导您完成使用 Giggle API 的所有步骤——从注册到发出第一个请求，大约只需 5 分钟。

概述

注册/登录 → 充值 → 获取 API 密钥 → 阅读文档 → 开始调用

访问 giggle.pro 并使用您的电子邮件或 Google 帐户注册或登录。

登录后，点击左下角的头像打开菜单，然后点击**“充值”**为您的帐户添加积分。

汇率：1 美元 = 100 积分。详情请参阅定价与结算。

点击左侧导航栏中的“API 密钥”打开 API 密钥管理页面。点击右上角的“+ 新建 API 密钥”生成您的密钥。

每个账户最多可创建 5 个 API 密钥。请妥善保存您的密钥，该密钥将不会再次显示。

安全提示：

切勿在公共代码库或客户端代码中共享您的 API 密钥

将您的 API 密钥安全地存储在环境变量中

定期轮换您的 API 密钥以提高安全性

访问API 文档以了解请求参数和响应格式。以下端点目前可用：

| 端点 | 方法 | 描述 |

|----------|--------|-------------|

| 图片转视频 | POST | 从图像生成视频 |

| 文本转视频 | POST | 从文本提示生成视频 |

| 全模态视频 | POST | 从多模态引用生成视频 |

| 查询任务 | GET |轮询生成任务的状态 |

在 x-auth 请求头中设置您的 API 密钥，并进行首次调用：

成功响应：

{

"code": 200,

"msg": "success",

"uuid": "87df77c8-12de-4bd6-91f1-3832c7bcecf9",

"data": {

"task_id": "your-task-id"

}
}

使用返回的 task_id 来轮询查询任务端点以获取结果：

当响应中的 status 字段为 completed 时，urls 字段将包含可下载的视频链接。