> ## Documentation Index
> Fetch the complete documentation index at: https://docs.1788.love/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

> 创建 API Key 并发起第一个 1788 API 请求

## 前提条件

* 已拥有 1788 账号和可用额度。
* 已在控制台创建 API Key。
* 使用支持 HTTPS 请求的工具，例如 cURL、Python 或 JavaScript。

## 调用流程

<Steps>
  <Step title="创建 API Key">
    登录 [1788 平台](https://1788.love)，在控制台创建一个 API Key。请只在服务端或安全的环境变量中保存它。
  </Step>

  <Step title="上传参考图片（可选）">
    图生视频需要先调用[上传图片](/api-reference/upload-image)接口，取得图片 URL。
  </Step>

  <Step title="创建视频任务">
    调用 `POST https://1788.love/v1/videos`。视频生成是异步任务，先获得任务 ID，再查询进度和结果。

    ```bash theme={null}
    curl --request POST \
      --url https://1788.love/v1/videos \
      --header 'Authorization: Bearer YOUR_1788_API_KEY' \
      --header 'Content-Type: application/json' \
      --data '{
        "model": "grok-imagine-1.5-video",
        "prompt": "一只狗在海滩上奔跑，阳光明媚，慢镜头",
        "size": "16:9",
        "duration": 6,
        "quality": "720p"
      }'
    ```
  </Step>
</Steps>

<Note>
  请求成功表示任务已被接收，不代表视频已经生成完成。上游最终失败、取消或超时的任务不会产生最终扣费。
</Note>