> ## 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.

# 上传图片

> 上传图片并获取可用于视频生成的参考图 URL

<Warning>
  不要在视频生成请求中传递 base64 图片。请先使用本接口上传文件，再将返回的 `url` 填入 `image_urls`。
</Warning>

## 请求

`POST https://1788.love/v1/uploads/images`

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_1788_API_KEY`
</ParamField>

<ParamField body="file" type="file" required>
  图片文件。支持 JPEG、PNG、WebP、GIF；最大 20 MB。
</ParamField>

<CodeGroup>
  ```bash cURL theme={null}
  curl --request POST \
    --url https://1788.love/v1/uploads/images \
    --header 'Authorization: Bearer YOUR_1788_API_KEY' \
    --form 'file=@/path/to/reference-image.png'
  ```

  ```python Python theme={null}
  import requests

  with open("reference-image.png", "rb") as image:
      response = requests.post(
          "https://1788.love/v1/uploads/images",
          headers={"Authorization": "Bearer YOUR_1788_API_KEY"},
          files={"file": image},
      )

  print(response.json())
  ```

  ```javascript JavaScript theme={null}
  const form = new FormData();
  form.append("file", fileInput.files[0]);

  const response = await fetch("https://1788.love/v1/uploads/images", {
    method: "POST",
    headers: { Authorization: "Bearer YOUR_1788_API_KEY" },
    body: form,
  });

  console.log(await response.json());
  ```
</CodeGroup>

## 成功响应

```json theme={null}
{
  "url": "https://1788.love/uploaded/example-image.png",
  "filename": "reference-image.png",
  "content_type": "image/png",
  "bytes": 235680,
  "created_at": 1785564000
}
```

<ResponseField name="url" type="string">
  图片 URL。将返回值原样放入视频请求的 `image_urls` 数组。
</ResponseField>

<ResponseField name="filename" type="string">
  原始文件名。
</ResponseField>

<ResponseField name="content_type" type="string">
  识别出的 MIME 类型，例如 `image/png`。
</ResponseField>

<ResponseField name="bytes" type="integer">
  文件大小，单位为字节。
</ResponseField>