本文将介绍一种 SeeDream Images Generation API 对接说明，它是可以通过输入自定义参数来生成 SeeDream 官方的图片。

申请流程

要使用 API，需要先到 SeeDream Images Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

首先先了解下基本的使用方式，就是输入提示词 prompt、 生成行为 action、图片尺寸 size，便可获得处理后的结果，首先需要简单地传递一个 action 字段，它的值为 generate，然后我们还需要输入提示词，具体的内容如下：

可以看到这里我们设置了 Request Headers，包括：

• accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
• authorization：调用 API 的密钥，申请之后可以直接下拉选择。

另外设置了 Request Body，包括：

• prompt：提示词。
• model：生成模型，默认 doubao-seedream-4.0。
• image: 输入的图片信息，支持 URL 或 Base64 编码。其中，doubao-seedream-4.5、doubao-seedream-4.0 支持单图或多图输入,doubao-seededit-3.0-i2i 仅支持单图输入,doubao-seededit-3.0-t2i 不支持该参
• size: 指定生成图像的尺寸信息，支持以下两种方式，不可混用。方式 1 | 指定生成图像的分辨率，并在prompt中用自然语言描述图片宽高比、图片形状或图片用途，最终由模型判断生成图片的大小。方式 2 | 指定生成图像的宽高像素值：默认值：2048x2048 根据模型不同默认值不同
• seed: 随机数种子，用于控制模型生成内容的随机性。取值范围为 [-1, 2147483647]。仅 doubao-seedream-3.0-t2i、doubao-seededit-3.0-i2i 支持该参数
• sequential_image_generation: 组图：基于您输入的内容，生成的一组内容关联的图片。仅 doubao-seedream-4.5、doubao-seedream-4.0 支持该参数， 默认 disabled
• stream: 控制是否开启流式输出模式。仅 doubao-seedream-4.5、doubao-seedream-4.0 支持该参数，默认是 false
• guidance_scale: 模型输出结果与prompt的一致程度，生成图像的自由度，又称为文本权重；值越大，模型自由度越小，与用户输入的提示词相关性越强。取值范围：[1, 10] 。doubao-seedream-3.0-t2i 默认值 2.5, doubao-seededit-3.0-i2i默认值 5.5， 其他不支持
• response_format: 指定生成图像的返回格式。默认是url，也支持b64_json
• watermark: 是否在生成的图片中添加水印。默认是 true
• callback_url：需要回调结果的 URL。

选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「Try」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "success": true,
  "task_id": "25027ba3-0430-4a1b-91c8-d2297f19ba73",
  "trace_id": "8043a9e9-692f-43b0-82f7-5890f798be38",
  "data": [
    {
      "prompt": "a white siamese cat",
      "size": "2048x2048",
      "image_url": "https://platform.cdn.acedata.cloud/seedream/3c060029-69b1-406f-a957-fcd55ddc9386.jpg"
    }
  ]
}

返回结果一共有多个字段，介绍如下：

• success，此时视频生成任务的状态情况。
• task_id，此时视频生成任务 ID。
• trace_id，此时视频生成跟踪 ID。
• data，此时图像生成任务的结果列表。
  • image_url，此时图片生成任务的链接。
  • prompt，提示词。
  • size: 生成图的像素

可以看到我们得到了满意的图片信息，我们只需要根据结果中 data 的图片链接地址获取生成的 SeeDream 图片即可。

另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：

1
2
3
4
5
6
7
8
9

curl -X POST 'https://api.acedata.cloud/seedream/images' \
-H 'accept: application/json' \
-H 'authorization: Bearer ${token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "doubao-seedream-4-0-250828",
  "prompt": "a white siamese cat"
}'

编辑图片任务

如果想对某张图片进行编辑的话， 首先参数image必须传入需要编辑的图片链接

• model：此次编辑图片任务所采用的模型，该任务目前支持 doubao-seedream-4.5、doubao-seedream-4.0 支持单图或多图输入，doubao-seededit-3.0-i2i 仅支持单图输入。
• image：上传需要编辑的图片，一张或者多张

填写样例如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20

import requests

url = "https://api.acedata.cloud/flux/images"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "doubao-seedream-4-0-250828",
  "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
  "image": ["https://ark-project.tos-cn-beijing.volces.com/doc_image/seedream4_5_imageToimage.png"],
  "size": "2K",
  "watermark": False
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

点击运行，可以发现会立即得到一个结果，如下：

1
2
3
4
5
6
7
8
9
10
11
12

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

可以看到，生成的效果是对原图片进行编辑的效果，结果与上文类似。

异步回调

由于 SeeDream Images Generation API 生成的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成图片的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

点击运行，可以发现会立即得到一个结果，如下：

1
2
3

{
  "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde"
}

内容如下：

1
2
3
4
5
6
7
8
9
10
11
12

{
    "success": true,
    "task_id": "c9aaffa2-b8ac-40ff-8468-43e77cb9ddde",
    "trace_id": "131a40c3-2eaf-44c9-af28-c9b408577286",
    "data": [
        {
            "prompt": "Keep the model pose and the liquid garment flowing shape unchanged. Change the clothing material from silver metal to completely transparent water (or glass). Through the liquid flow, the details of the model skin are visible. The light and shadow effect shifts from reflection to refraction.",
            "size": "2048x2048",
            "image_url": "https://platform.cdn.acedata.cloud/seedream/3e88db7e-4771-4f6a-adbd-5ae4590c5d59.jpg"
        }
    ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

• 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
• 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
• 401 invalid_token：Unauthorized, invalid or missing authorization token.
• 429 too_many_requests：Too many requests, you have exceeded the rate limit.
• 500 api_error：Internal server error, something went wrong on the server.

错误响应示例

1
2
3
4
5
6
7
8

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

通过本文档，您已经了解了如何使用 SeeDream Images Generation API 可通过输入提示词来生成图片。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

随着 AI 的应用变广，各类 AI 程序已逐渐普及。AI 已逐渐深入到人们的工作生活方方面面。而 AI 涉及的行业也越来越多，从最初的写作，到医疗教育，再到现在的音乐。

Suno 是一个专业高质量的 AI 歌曲和音乐创作平台，用户只需输入简单的文本提示词，即可根据流派风格和歌词生成带有人声的歌曲。该 AI 音乐生成器由来自 Meta、TikTok、Kensho 等知名科技公司的团队成员开发，目标是不需要任何乐器工具，让所有人都可以创造美妙的音乐。

Suno 最新已将音乐生成模型升级到 V3 版本，可生成 2 分钟的歌曲。

然而 Suno 官方是并没有提供 API 的，AceDataCloud 提供了一套 Suno 的 API，模拟对接了 Suno 官方，可以方便快捷地生成想要的音乐。

申请和使用

要使用 Suno Audios API，首先可以到 Suno Audios Generation API 页面点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

想些什么歌曲，可以任意输入一段文字，比如我想生成一个关于圣诞的歌曲，就可以输入 a song for Christmas，如图所示：

生成的代码如下：

可以点击「Try」按钮直接测试 API，稍等 1-2 分钟，结果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29

{
  "success": true,
  "data": [
    {
      "id": "2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5",
      "title": "Winter Wonderland",
      "image_url": "https://cdn1.suno.ai/image_2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.png",
      "lyric": "[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near",
      "audio_url": "https://cdn1.suno.ai/2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.mp3",
      "video_url": "https://cdn1.suno.ai/2f16f7bc-4135-42c6-b3c5-6d6c49dc8cd5.mp4",
      "created_at": "2024-05-10T16:21:37.624Z",
      "model": "chirp-v3",
      "prompt": "A song for Christmas",
      "style": "holiday"
    },
    {
      "id": "5dca232b-17cc-4896-a2d1-4b59178bf410",
      "title": "Winter Wonderland",
      "image_url": "https://cdn1.suno.ai/image_5dca232b-17cc-4896-a2d1-4b59178bf410.png",
      "lyric": "[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near",
      "audio_url": "https://cdn1.suno.ai/5dca232b-17cc-4896-a2d1-4b59178bf410.mp3",
      "video_url": "https://cdn1.suno.ai/5dca232b-17cc-4896-a2d1-4b59178bf410.mp4",
      "created_at": "2024-05-10T16:21:37.624Z",
      "model": "chirp-v3",
      "prompt": "A song for Christmas",
      "style": "holiday"
    }
  ]
}

可以看到这时候我们就得到了两首歌的内容，包括标题、预览图、歌词、音频、视频等内容。

字段说明如下：

• success：生成是否成功，如果成功则为 true，否则为 false
• data：是一个列表，包含了生成的歌曲的详细信息。
  • id：歌曲 ID
  • title：歌曲的标题
  • image_url：歌曲的封面图片
  • lyric：歌曲的歌词
  • audio_url：歌曲的音频文件，打开就是一个 mp3 音频。
  • video_url：歌曲的视频文件，打开就是一个 mp4 视频。
  • created_at：创建的时间
  • model：使用的模型，一般是最新的 v3 模型
  • style：风格

自定义生成

如果想自定义生成歌词，可以输入歌词：

这时候 lyric 字段可以传入类似如下内容：

1

[Verse]\nSnowflakes falling all around\nGlistening white\nCovering the ground\nChildren laughing\nFull of delight\nIn this winter wonderland tonight\nSanta's sleigh\nUp in the sky\nRudolph's nose shining bright\nOh my\nHear the jingle bells\nRinging so clear\nBringing joy and holiday cheer\n[Verse 2]\nRoasting chestnuts by the fire's glow\nChristmas lights\nThey twinkle and show\nFamilies gathering with love and cheer\nSpreading warmth to everyone near

注意，这里的歌词中 \n 是换行符，如果你不知道如何生成歌词，可以使用下文介绍的生成歌词的 API 自助生成。

接下来我们要根据歌词、标题、风格自定义生成歌曲，就可以指定如下内容：

• lyric：歌词文本
• custom：填写为 true，代表自定义生成，该参数默认为 false，代表使用 prompt 生成。
• file：歌曲的标题。
• style：歌曲的风格，选填。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/suno/audios' \
-H 'authorization: Bearer {token}' \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-d '{
"lyric": "[Verse]\\nSnowflakes falling all around\\nGlistening white\\nCovering the ground\\nChildren laughing\\nFull of delight\\nIn this winter wonderland tonight\\nSanta's sleigh\\nUp in the sky\\nRudolph's nose shining bright\\nOh my\\nHear the jingle bells\\nRinging so clear\\nBringing joy and holiday cheer\\n[Verse 2]\\nRoasting chestnuts by the fire's glow\\nChristmas lights\\nThey twinkle and show\\nFamilies gathering with love and cheer\\nSpreading warmth to everyone near",
"custom": true
}'

测试允许，生成的效果是类似的。

异步回调

由于 Suno 生成音乐的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成音乐的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入 prompt，如图所示：

点击运行，可以发现会立即得到一个结果，如下：

1
2
3

{
  "task_id": "44472ab8-783b-4054-b861-5bf14e462f60"
}

稍等片刻，我们可以在 https://webhook.site/03e60575-3d96-4132-b681-b713d78116e2 上观察到生成歌曲的结果，如图所示：

内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

{
  "success": true,
  "task_id": "44472ab8-783b-4054-b861-5bf14e462f60",
  "data": [
    {
      "id": "da4324e5-84b2-484b-b0e9-dd261381c594",
      "title": "Winter Whispers",
      "image_url": "https://cdn1.suno.ai/image_da4324e5-84b2-484b-b0e9-dd261381c594.png",
      "lyric": "[Verse]\nSnow falling gently from the sky\nChildren giggling as they pass by\nFire crackling\nCozy and warm\nChristmas spirit begins to swarm\n[Verse 2]\nTwinkling lights\nA sight to behold\nStockings hung\nWaiting to be filled with gold\nGifts wrapped with love\nPiled high\nExcitement in the air\nYou can't deny\n[Chorus]\nWinter whispers in the wind\nJoy and love it brings\nLet's celebrate this season\nWith the ones we're missing",
      "audio_url": "https://cdn1.suno.ai/da4324e5-84b2-484b-b0e9-dd261381c594.mp3",
      "video_url": "https://cdn1.suno.ai/da4324e5-84b2-484b-b0e9-dd261381c594.mp4",
      "created_at": "2024-05-11T07:33:05.430Z",
      "model": "chirp-v3",
      "prompt": "A song for Christmas",
      "style": "pop"
    },
    {
      "id": "b878a87b-a0db-4046-8ccd-ecd2fb3d4372",
      "title": "Winter Whispers",
      "image_url": "https://cdn1.suno.ai/image_b878a87b-a0db-4046-8ccd-ecd2fb3d4372.png",
      "lyric": "[Verse]\nSnow falling gently from the sky\nChildren giggling as they pass by\nFire crackling\nCozy and warm\nChristmas spirit begins to swarm\n[Verse 2]\nTwinkling lights\nA sight to behold\nStockings hung\nWaiting to be filled with gold\nGifts wrapped with love\nPiled high\nExcitement in the air\nYou can't deny\n[Chorus]\nWinter whispers in the wind\nJoy and love it brings\nLet's celebrate this season\nWith the ones we're missing",
      "audio_url": "https://cdn1.suno.ai/b878a87b-a0db-4046-8ccd-ecd2fb3d4372.mp3",
      "video_url": "https://cdn1.suno.ai/b878a87b-a0db-4046-8ccd-ecd2fb3d4372.mp4",
      "created_at": "2024-05-11T07:33:05.430Z",
      "model": "chirp-v3",
      "prompt": "A song for Christmas",
      "style": "pop"
    }
  ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

歌词生成

如果你想自定义生成歌曲，但又不太想自己编写歌词，可以使用 AceDataCloud 提供的歌词生成 API 来通过 prompt 生成歌词，API 是 Suno Lyrics Generation API。

该 API 只有一个输入参数，就是 prompt，填写样例如下：

这里我们输入的 prompt 是 A song about winter，生成和冬天相关的歌曲。

点击运行，结果如下：

1
2
3
4
5
6
7
8
9

{
  "success": true,
  "task_id": "57e8ce3a-39cb-41a2-802f-e70a324f4d0a",
  "data": {
    "text": "[Verse]\nSnowflakes falling from the sky\nWinter's cold touch\nOh how it gets me high\nI bundle up in layers\nOh so cozy\nStepping out and feeling the frost on my nose\nSee\n\n[Verse 2]\nThe world is covered in a blanket of white\nIcicles hanging\nShimmering so bright\nThe chilly air fills my lungs with every breath\nWalking in the snow\nLeaving footprints that won't be left\n\n[Chorus]\nOh\nWinter's cold touch\nIt's a season that I love so much\nSnowfall brings a feeling so divine\nWinter's cold touch\nIt's a magical time",
    "title": "Winter's Cold Touch",
    "status": "complete"
  }
}

可以看到，data 的 text 字段就是歌词信息，这个信息可以用于上文的自定义歌曲生成。

一、核心痛点与 API 定位

做 SEO 优化总踩坑？跨境选品没方向？竞品广告策略摸不透？在谷歌算法迭代频繁的今天（最新内部文档披露含 2596 个排名模块），精准实时的 SERP 数据直接决定营销成败。但传统数据获取方式痛点明显：

• 手动抓取：1 条数据需 10 分钟，效率极低；
• 自建爬虫：频繁被封，数据格式混乱，无法直接使用。

专为企业级需求打造的 ACE Data Platform Google SERP API，依托平台核心数据采集与解析能力（详见官方能力文档：ACE Data Platform 官方能力文档），将复杂的 SERP 数据获取简化为 1 行 API 调用。开发者、SEO 运营、市场分析师无需关注底层技术，即可快速拿到结构化全量数据，让数据驱动决策落地。

二、四大核心优势，重新定义 SERP 数据获取体验

对比传统抓取和普通 API，ACE Data Platform 凭 4 大核心能力成为 2000+ 企业首选，优势突出：

1. 实时精准响应，3 秒直达全量数据

• 依托全球分布式节点集群与智能调度算法，3 秒内返回实时数据，零缓存延迟，匹配谷歌最新搜索反馈；
• 支持网页、图片、新闻、购物卡片、知识图谱、广告区块等全类型 SERP 元素抓取，覆盖排名位置、标题、描述、URL、关键词密度、广告出价区间、EEAT 相关因子等核心字段；
• 结构化 JSON 格式直接输出，无需二次解析，无缝对接业务系统、AI 模型或数据分析工具。

2. 全域场景覆盖，灵活适配多元需求

• 支持 190+ 国家/地区、130+ 语种的地域化配置，适配本地化业务关键词监测与跨语种全球市场分析；
• 可模拟桌面端、移动端等多设备搜索场景，自定义搜索参数匹配信息型/交易型/导航型等特定用户画像的搜索意图；
• 完美覆盖本地化营销、跨境电商选品、全球竞品监测等多元需求。

3. 极致稳定抗反爬，保障业务连续运行

• 通过动态 IP 池、智能验证码识别、浏览器指纹模拟等多重抗反爬策略，规避谷歌严格反爬限制，API 可用性高达 99.9%；
• 企业无需投入人力维护代理池和反爬逻辑，大幅降低运维成本，确保数据获取全程稳定不中断。

4. 低门槛集成，按需付费更经济

• 提供超详细开发文档（含多语言示例代码），支持 Python、JavaScript、Java 等全主流编程语言，新手 10 分钟完成集成调试；
• 采用“按需付费”模式，无强制月度订阅；高并发场景支持弹性扩容，每秒可处理 300+ 查询请求，适配初创团队与大型集团需求。

三、六大核心应用场景，解锁 SERP 数据商业价值

灵活适配多场景，让 SERP 数据转化为商业价值，更可借助 AI agent 赋能内容创作，成为企业增长“隐形引擎”：

1. SEO 优化与排名监测：实时追踪核心关键词在不同地区、设备的自然排名变化，定位排名波动原因，分析竞品 SEO 策略与内容差距，针对性优化内容和链接布局，提升谷歌搜索曝光率与自然流量。
2. 竞品情报分析：抓取竞品谷歌广告文案、着陆页信息、关键词布局，洞察其市场定位与营销重点；监测竞品购物搜索中的价格、评分、销量数据，为自身定价、产品迭代和广告策略优化提供参考。
3. AI 应用搭建：为AI聊天机器人、智能问答系统、RAG 应用提供实时谷歌搜索数据支撑，提升 AI 模型回答准确性与时效性，打造更智能的产品体验。
4. AI agent 驱动爆款文章创作：获取特定领域 Google SERP Top 排名爆款文章数据（标题结构、内容框架、关键词分布、用户互动数据等），由 AI agent 分析爆款规律，自动生成符合谷歌搜索偏好的文案或创作提纲，降低内容创作成本与试错成本。
5. 市场调研与趋势预测：分析特定行业关键词的 Google SERP 数据，洞察全球市场需求变化、消费者偏好趋势，为产品研发、市场扩张、营销策略制定提供数据依据。
6. 跨境电商选品：抓取 Google Shopping 搜索结果中的热门产品、价格区间、用户评价等数据，识别高需求、低竞争的潜力选品，降低跨境电商运营风险。

四、3 步快速接入，即刻启用

1. 注册 ACE Data Platform 账号，在控制台获取专属 API Key；
2. 参考官方文档（ACE Data Platform 官方能力文档），配置关键词、地区、设备、语言等查询参数；
3. 通过任意编程语言发送 HTTP 请求，获取结构化 Google SERP 数据，对接业务系统完成分析或应用开发。

五、总结号召

全球市场竞争已进入“数据竞速”时代，高效、精准掌握 Google SERP 数据是抢占先机的关键。ACE Data Platform Google SERP API 以“高效、精准、稳定、经济”的核心优势，跳过数据获取的所有坑，更能联动 AI agent 赋能内容创作，让爆款文章轻松量产。

立即注册 ACE Data Platform（ACE Data Platform 官网），领取免费额度，开启 Google SERP 数据驱动增长之路！

补充：ACE Data Cloud 平台实力背书

• 平台背景：由 Germey 创立，团队具备丰富行业经验，致力于提供全球顶级数字服务；
• 创始人资质：Germey 拥有 10+ 年软件开发经验，GitHub 全球粉丝排名 TOP 500，著有《Practical Python3 Web Scraping Development》（Python 创始人 Guido 推荐，全球销量超 15 万册），主导数百个开源项目，参与项目 Stars 超 4 万，开源镜像下载量超 100 万次；
• 服务保障：提供全球在线客户支持与全面集成文档，24x7 监控维护，确保服务稳定运行。

活动：2026.1.21~2026.1.27 期间开通自动发布并成功截图，可获得每日最高 50 积分≈￥48奖励（发布一个平台 10 积分），每日统计，可以叠加。

本 SOP 用于指导团队完成两件事：
1）安装 Ace Data Cloud 浏览器插件并完成账号授权；
2）在 Ace Data Cloud 平台完成频道绑定、内容准备、发布与自动发布。

1. 目标与概述

• 目标：通过 Ace Data Cloud 平台，将文章/视频等内容分发到多个自媒体平台（频道），提升分发效率，并通过自动发布实现“低人工投入”的持续推广。
• 前置条件：
  • 使用 Chrome 浏览器
  • 可访问 Ace Data Cloud 平台
  • 已下载浏览器插件压缩包并解压
  • 浏览器插件配置文档（平台内）：链接

2. 核心概念说明

• 浏览器插件：用于在第三方平台（如知乎、CSDN 等）完成账号授权，使 Ace Data Cloud 能代表你执行发布。
• 频道（Channels）：目标发布平台的账号授权通道（如知乎、CSDN、掘金等）。
• 材料（Materials）：平台提供的可直接使用/参考的预制内容库。
• 文档（Docs）：你准备发布的内容草稿（可由材料生成，也可自己创建）。
• 发布任务（Tasks）：每一次发布操作生成的记录，用于追踪状态、链接与结果。

3. 插件安装 SOP

3.1 下载插件

1. 访问下载链接并下载压缩包：
   • https://cdn.acedata.cloud/i9h4af.zip
2. 解压后得到一个插件文件夹（保持文件夹结构不变）。

3.2 安装插件（Chrome）

1. 在 Chrome 地址栏输入：chrome://extensions
2. 打开右上角 开发者模式（Developer mode）
3. 点击 Load unpacked（加载已解压的扩展程序）
4. 选择你刚刚解压出来的插件文件夹并确认

3.3 安装成功验证

1. 打开 Ace Data Cloud 分发中心页面并刷新：
   • https://platform.acedata.cloud/console/publish
2. 如果页面不再出现“未安装浏览器插件”的提示，则安装成功。

4. 内容发布平台 SOP（含截图）

以下 SOP 以平台页面为主线：分发中心 → 频道 → 文档/材料 → 发布任务 → 自动发布
截图说明：

• 截图1：发布中心
• 截图2：频道管理
• 截图3：发布任务
• 截图4：发布概览/摘要

4.1 步骤一：进入发布中心（总览与自动发布开关）

• 目标：确认插件状态正常，并了解“自动发布”入口与整体状态。

操作：

1. 进入分发中心： https://platform.acedata.cloud/console/publish
2. 检查是否存在“未安装插件”等异常提示
3. 熟悉页面内的自动发布模块、整体概览信息

检查点：

• 页面正常显示，无插件缺失提示
• 能看到自动发布模块（开关/说明）

截图1（发布中心）

4.2 步骤二：绑定发布频道（授权第三方账号）

• 目标：将第三方平台账号授权给 Ace Data Cloud，建立发布通道。

操作：

1. 进入频道页面： https://platform.acedata.cloud/console/publish/channels
2. 找到需要绑定的平台（如知乎、CSDN 等）
3. 点击 绑定，按提示完成第三方平台登录与授权
4. 绑定成功后，频道状态应变为 有效

检查点：

• 目标平台频道状态显示 有效
• 可绑定多个频道以实现“一文多发”

截图2（频道管理）

4.3 步骤三：准备内容（从材料库创建文档 / 编辑文档）

• 目标：获得可发布的文章草稿，并进行必要编辑。

常见路径 A：从材料库选取并生成文档

1. 在“材料”库中浏览/搜索内容
2. 查看标题、内容与支持频道
3. 点击 预览确认内容适用
4. 点击 使用：系统会将材料复制到你的“文档”列表，形成可编辑草稿

常见路径 B：创建原创文档（如平台支持“新建文档”）

1. 在“文档”页面点击 新建
2. 输入标题与正文，保存为草稿

检查点：

• 文档已生成并可进入编辑页
• 标题、正文、格式符合目标平台发布要求

4.4 步骤四：手动发布（选择频道并生成发布任务）

• 目标：将指定文档发布到已绑定的多个频道。

操作：

1. 在“文档”列表找到目标文章
2. 进入编辑页完成最终检查（标题优化、排版、链接等）
3. 点击 发布
4. 在弹窗中勾选要发布的 频道
5. 确认发布 → 系统创建 发布任务

检查点：

• 发布任务已生成
• 状态从“进行中”变为“已完成”
• 可点击任务中的链接，跳转第三方平台确认文章已发布

4.5 步骤五：查看发布任务（追踪状态与结果链接）

• 目标：统一查看手动/自动发布的历史与结果。

操作：

1. 进入发布任务页面（或从分发中心进入任务列表）
2. 查看任务状态、发布时间、目标频道与外链
3. 异常任务根据提示重试或重新授权频道

检查点：

• 任务状态清晰可追踪
• 已完成任务具备可访问的外链

截图3（发布任务）

4.6 步骤六：启用自动发布（全自动分发）

• 目标：开启自动发布后，系统按规则自动选取内容并发布到“有效频道”。

操作：

1. 返回 发布中心
2. 找到 自动发布 模块
3. 将开关从“关闭”拨动至“打开”
4. 后续定期到“发布任务”确认系统自动创建的任务与完成情况

检查点：

• 自动发布开关处于开启状态
• 发布任务中持续出现自动任务记录

截图4（发布概览/摘要）

5. 常见问题（FAQ）

Q1：频道绑定失败 / 状态显示“已过期”怎么办？

• 建议操作：先 解绑 再 重新绑定，按页面提示重新完成授权登录。
• 若仍失败：检查浏览器插件是否安装启用、第三方平台是否触发风控/二次验证。

Q2：可以发布我自己写的原创文章吗？

• 可以。一般在“文档”页面支持 新建文档，创建后按“手动发布”流程发布。

Q3：自动发布的内容不喜欢，可以干预吗？

• 可以。随时关闭发布中心的 自动发布 开关。
• 同时你也可以只绑定你希望自动分发的平台频道，减少不期望的平台覆盖。

Q4：如何查看发布效果（阅读量/互动等）？

• 在 发布任务 中点击外链进入第三方平台查看数据；
• 平台内若有统计模块，也可在概览/报表中查看汇总。

6. 总结（最短路径）

• 插件安装成功 → 绑定频道（有效） → 准备文档 → 发布并查看任务 → （可选）开启自动发布

最近被谷歌新发布的 Nano Banana（Gemini 2.5 Flash Image）图像生成模型 霸屏了。

从手办秒变真人级 Cosplay，到一键统一多图风格，从个性化头像到产品概念设计，甚至连静态画作都能一键生成电影级动态分镜——这波 AI 生图浪潮，真的在重新定义创作！

Ace Data Cloud 平台 https://platform.acedata.cloud 现也推出 Nano Banana API：价格：约 ¥0.10/张，成本相比官方直接省一半，性能效果毫不打折。是更快、更稳、更省钱的图片生产线

Nano Banana 强在哪？

它最厉害的地方，是能轻松实现 高精度的一致性生成。
无论是换背景、改风格、调表情，还是处理复杂动作与服装，过渡都非常自然，效果高度统一，几乎看不出 AI 生成的痕迹！

超实用的玩法示例

1. 2D 图片转 3D 手办

当前最火的出圈玩法！

指令：生成一幅图片中角色的商品化模型，环境写实。模型放电脑桌上，使用圆形亚克力底座。电脑屏幕显示建模过程，旁边放置印有原图的 BANDAI 包装盒。

2. 产品内部结构解析

提示词：超详细的产品爆炸视图，金属零件和电子元件漂浮在半空中，完美排列，揭示内部结构，未来主义技术美学，8K 分辨率，柔和的电影照明，高度逼真。背景是纯白色。

3. 老照片修复

提示词：请修复这张充满划痕的黑白老照片。移除所有污点和破损，大幅提升清晰度，并进行自然、逼真的上色。

4. 多元素组图 / 电商产品植入

提示词：一位模特站在一辆白色的车前面摆拍，场景为街区路面，两边是建筑。她穿着黑色连衣裙和白色高跟鞋，一手拎着白色的包。

还有更多实用场景：一键换装/换表情/换动作、多角度镜头、人物合影、表情包九宫格、模特 OOTD 服装平铺展示、手稿转 3D 实物图、建筑等轴测建模、地图转实景解析……统统都能高效完成！

在展示了 Nano Banana 如此多令人惊艳的玩法之后，你可能会想：这么强大的能力，接入起来一定很复杂，成本也很难控制吧？
无论是 AI 产品的开发者想要快速集成，还是个人用户希望直接体验，Ace Data Cloud 都让这一切变得简单、可控且经济。

价格

说到价格，Ace Data Cloud 绝对是你的性价比之选：

• Google 官方：约美元 $0.039/张，按 $1 ≈ ¥7.2 计算，人民币大约 ¥0.28/张。
• AceDataCloud：统一 ¥0.10/张。

另外并发支持更宽裕，响应更稳定，提供专属客服，7×24 小时可用性保障，具体价格与配额请见：https://platform.acedata.cloud/services/nano-banana。

快速接入，立即体验高品质低成本图像生成！

我们提供简洁的 API 和完整的开发文档，助你快速集成到既有工作流或新产品。

• 开发集成文档：https://platform.acedata.cloud/documents/nano-banana-images-integration
• 立即购买与使用：https://platform.acedata.cloud/documents/nano-banana-images-integration
• 技术支持与咨询：随时联系我们的技术团队：https://platform.acedata.cloud/support

下面是样例调用说明，轻松一个 API 就能得到你想要的效果：

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/nano-banana/images' \
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
    "action": "generate",
    "prompt": "A photorealistic close-up portrait of an elderly Japanese ceramicist with deep, sun-etched wrinkles and a warm, knowing smile. He is carefully inspecting a freshly glazed tea bowl. The setting is his rustic, sun-drenched workshop. The scene is illuminated by soft, golden hour light streaming through a window, highlighting the fine texture of the clay. Captured with an 85mm portrait lens, resulting in a soft, blurred background (bokeh). The overall mood is serene and masterful. Vertical portrait orientation."
  }'

返回结果：

1
2
3
4
5
6
7
8
9
10
11

{
  "success": true,
  "task_id": "056f0589-a3dd-4ec2-8440-ad61f5038dfa",
  "trace_id": "c48de83f-0077-426e-b02b-ff1d58179064",
  "data": [
    {
      "prompt": "A photorealistic close-up portrait of an elderly Japanese ceramicist with deep, sun-etched wrinkles and a warm, knowing smile. He is carefully inspecting a freshly glazed tea bowl. The setting is his rustic, sun-drenched workshop. The scene is illuminated by soft, golden hour light streaming through a window, highlighting the fine texture of the clay. Captured with an 85mm portrait lens, resulting in a soft, blurred background (bokeh). The overall mood is serene and masterful. Vertical portrait orientation.",
      "image_url": "https://platform.cdn.acedata.cloud/nanobanana/69790adb-c85d-4362-ad9e-0c9ba4352cf4.png"
    }
  ]
}

其中 image_url 就是 Nano Banana 生成的的图片，永久可访问。

总结

好了，以上就是 Ace Data Cloud 的 Nano Banana API 的介绍，快来试试吧！

一、nano-banana 爆火背景与核心优势

最近 AI 圈彻底被“纳米香蕉”承包！X 平台 16 万浏览量的 3D 手办生成图、网友复刻的《黑神话·钟馗》周边、老照片修复、跨时空合照等玩法刷屏全网。其本质是谷歌 Gemini 2.5 Flash Image 模型的“隐藏款”，通过 API 调用可将“创意超能力”植入自有产品或工作流。

官方API痛点

官方 API 存在两大核心问题：① 成本高，0.039 美元/张（约0.28元）；② 受网络限制，大规模调用成本压力大。

ACE Data Platform 生态加持优势

推荐 ACE Data Platform的nano-banana API 接入方案（专属对接链接：ACE Data Platform nano-banana API专属对接页面），核心优势：兼顾低成本（0.1 元/张量产）、高稳定、强扩展性，适配个人创作与商业部署全场景。

二、4 大核心能力（碾压同类的硬实力）

nano-banana API 凭以下 4 大功能成为开发者“生产力利器”：

1. 角色一致性拉满：多次编辑可精准保留人物脸部特征、发型与服装风格，更换场景、调整姿势后主体辨识度仍在线；适配虚拟试衣 APP、连贯故事分镜生成等场景，无需反复调整参数。
2. 多图融合自然到离谱：支持一次性上传 13 张素材图，智能整合光线、阴影、透视关系，实现“原生融合”而非简单拼接；电商商家可合成产品场景图，设计师可快速组合创意元素，效率提升 10 倍以上。
3. 多轮编辑像“聊天”一样简单：支持基于上一轮结果持续微调，如为空房间逐步添加家具、粉刷墙壁，或给生成图换风格、改细节；无需每次重新描述全部需求，对话式操作堪比真人设计师协作。
4. 生成速度快到飞起：“Flash”命名名副其实，复杂指令下13秒可生成5张风格各异的高清图，单张生成耗时不足3秒，完全满足商业场景高并发需求。

三、4 大落地场景（覆盖从创意到商业的全需求）

nano-banana API 适配性极强，个人创作者与企业开发均能找到核心价值：

1. 内容创作领域：自媒体人生成短视频封面、故事板；设计师借助风格迁移功能快速尝试不同创意方向，将 1 天工作量压缩至 1 小时。
2. 电商营销场景：生成多角度产品展示图、将商品自然植入生活场景；无需搭建实景拍摄，即可产出高质量营销素材，大幅降低推广成本。
3. 娱乐应用开发：开发虚拟试衣、宠物变装、老照片修复等趣味功能；依托强互动性提升产品用户留存率。
4. 企业级创意生产：品牌方批量生成品牌一致的广告素材，游戏公司制作角色周边可视化图；借助API实现“创意量产”，缩短项目周期。

四、2 套接入方案（避坑指南：成本直降+稳定翻倍）

针对不同需求提供适配方案，规避官方API网络波动、高成本、失败计费等问题：

1. 个人学习/小规模测试

• 方案：直接使用网页版（链接：nano-banana 网页版（无需配置，即开即用））
• 优势：无需任何网络配置，联网即可使用，操作便捷。

2. 商业部署/大规模调用（推荐方案）

• 方案：通过 ACE Data Platform接入nano-banana API（专属通道：ACE Data Platform nano-banana API 专属对接页面）
• 3大核心优势：
  ① 成本更友好：生态协同降低中转成本，大规模调用享阶梯价，失败调用不计费，比直接对接官方节省 30% 以上成本；
  ② 网络更稳定：国内直连节点，无需额外配置代理，API可用性高达 99.9%，避免网络波动导致创作或开发中断；
  ③ 生态更完整：可直接联动 ACE Data Platform 的其他 API 和编排系统，实现进一步自动化。

五、3 步快速接入流程（即刻解锁创意超能力）

1. 注册 ACE Data Platform 账号，进入 nano-banana API 专属对接页面（链接：ACE Data Platform nano-banana API专属对接页面），获取专属API Key；
2. 参考平台提供的开发文档（含Python、JavaScript等多语言示例代码），根据需求配置参数（支持图像生成、编辑、风格迁移等多种指令）；
3. 发起调用并对接自有系统，生成的图像可直接存储至 ACE Data Platform 平台云空间。

六、总结号召

从网友整活的趣味工具，到开发者追捧的生产力 API，nano-banana 的爆发绝非偶然。借助 ACE Data Platform的生态加持，不仅能低成本接入，更能通过数据联动实现价值升级。无论你是想做创意工具、电商产品，还是企业级营销系统，nano-banana API 都是不可错过的核心能力，赶紧领取免费额度，开启创意爆发之旅！

2026 年流量主战场已锁定视频端！小红书 15 秒种草视频 10万+ 赞、抖音 30 秒品牌故事破百万播放、视频号直播切片单日引流 500+ 精准客资… 但 90% 想靠视频变现的人，都被这些难题卡住：

• 专业剪辑要学 3 个月，新手望而却步；
• 找团队拍 1 条商业视频花 2000+，中小商家扛不住；
• 批量产出就掉画质，同质化严重没流量；
• AI 生成视频参数复杂+网络受限，劝退99%开发者

别慌！刷屏创作者圈的「视频量产神器」——Veo API 来了！AI 驱动的视频生成与编辑 API，让你 0 专业门槛、低成本批量产出高清商业级视频，更有 Ace Data Platform 生态加持（专属对接链接：Ace Data Platform 官网），稳定省心，个人创作、企业部署全 hold 住！

一、4 大核心能力封神！Veo 凭什么成生产力救星？

直接把视频制作效率拉到天花板，全网创作者疯狂跟风的硬实力：

1. 文本/图片一键转视频，小白也能 1 分钟出片
   输入文字脚本、上传产品图/素材图，Veo 自动匹配场景、添加转场特效、生成字幕和背景音乐，无需手动调参！种草视频、产品介绍、知识科普全搞定，1 分钟干完别人 1 天的活。

2. 4K 超清画质+多风格适配，商业级质感拉满
   支持 4K/1080P 超清输出，色彩还原度超高、细节无模糊！ins 风、国潮风、科技感、治愈系等 100+ 风格模板任选，还能自定义品牌色调、水印，助力打造专属 IP，质感碾压同行。

3. 智能剪辑+批量生成，效率直接翻 10 倍
   批量导入脚本生成多条视频，自动规避重复片段；智能截取高光，精准适配小红书（15s）、抖音（30s）、视频号（60s）等平台时长要求，无需二次修改，日更不熬夜。

4. 多模态交互+高兼容性，开发 10 分钟接入
   支持文本、图像多模态指令，可对接自有素材库；适配 Python、JavaScript 等全主流编程语言，提供详细开发文档和示例代码，新手开发者也能快速上手调试。

二、5 大落地场景，覆盖从个人到企业全需求

不同用户都能找到核心价值，流量变现、降本增效一把抓：

1. 自媒体创作：批量生成知识科普、书单/影单分享、短视频封面，轻松维持日更，抢占流量红利，不用熬夜剪辑！

2. 电商营销：产出产品多角度展示、场景化种草、直播切片视频，无需实景拍摄，营销素材成本直降 90%，转化率提升3倍+！

3. 企业培训：文字手册、PPT 一键转动画培训视频，生动易懂，员工学习效率翻倍；还能批量生成不同岗位定制化内容！

4. 品牌营销：批量产出品牌宣传、节日营销、活动预热视频，风格统一覆盖全平台，快速提升品牌曝光度和用户记忆点！

5. 娱乐开发：开发视频变装、AI 换脸、老视频修复等趣味 APP 功能，强互动性拉满用户留存率和分享欲，打造爆款应用！

三、避坑指南！成本直降 1/3

商业部署/大规模调用：Ace Data Platform 协同方案（强推！）
通过专属通道接入（链接：Veo API专属对接页），3大优势解决所有痛点：

• 成本更低：阶梯定价+失败调用不计费，比官方直连节省 30%+ 成本，中小商家无压力；
• 网络更稳：国内直连专属节点，无需额外配置代理，API 可用性 99.9%，批量生成不卡顿、不中断；
• 生态更全：联动平台其他 API，可以实现更高效率生成视频，一站式解决您制作视频的所有步骤。

四、3 步快速接入，解锁视频量产超能力

1. 注册 Ace Data Platform 账号，进入Veo API 专属对接页，领取专属 API Key；
2. 参考多语言示例代码（含 Python、JavaScript 等），按需配置文本转视频、图片转视频、智能剪辑等参数；
3. 发起调用并对接自有系统/创作工具，生成视频自动存储至平台云空间！

五、限时福利！手慢无！

新用户注册 Ace Data Platform，直接解锁 Veo API 免费体验额度！
无套路！个人/企业通用 | 零成本试错 | 即领即用！
点击直达领取：Veo API 免费体验通道

2026 视频流量风口，拼的就是「量产能力」+「内容质感」！Veo API 帮你跳过专业门槛、砍掉高成本，Ace Data Platform 生态更让视频创作从“盲目产出”升级为“精准变现”～

不管你是想靠短视频变现的自媒体人，还是想降本增效的电商商家、企业营销人员，这波免费体验机会千万别错过！先体验再决策，零风险开启视频量产爆发之旅！

还在为做视频发愁？专业剪辑学不会、找团队拍1条要花2000+、AI生成视频参数复杂搞不懂、批量做还总卡顿失败？别让技术门槛挡住视频流量红利！

ACE Data Platform重磅推出Sora 2 API专属集成方案，彻底打破视频创作的技术壁垒——不用写1行代码、不用懂专业知识，输入文字、上传图片就能生成4K电影级视频，还送免费额度+99.9%稳定服务，个人创作、企业批量产出全hold住！专属对接链接：ACE Data Platform Sora 2 API 开通页

一、核心优势：为什么大家都选ACE集成Sora 2？

对比传统视频制作和普通AI工具，ACE专属方案直接戳中痛点：

1. 0代码上手：不用懂技术，全程可视化操作，小白1分钟就能出片；
2. 双版本灵活选：基础版支持10-15秒短视频，高级版能做25秒长视频，满足不同场景；
3. 3种生成模式：文本生视频、图片变视频、定制虚拟角色视频，想要的效果都能实现；
4. 批量生成不卡顿：支持一次做多条，生成过程不占用设备，结果自动通知你；
5. 省心又省钱：国内直接使用，不用额外配置，生成视频自动备份，成本比找团队低90%。

二、3步免费开通：1分钟解锁视频超能力

开通流程简单到离谱，不用复杂审核，人人可领免费额度：

1. 点击专属链接：ACE Data Platform Sora 2 API 开通页；
2. 点击页面“Acquire”按钮，没注册的话简单填信息注册登录，自动返回开通页；
3. 开通成功后，系统直接送免费额度，就能立刻开始生成视频。

三、核心功能：3种生成方式，满足所有视频需求

1. 文本生视频：输入文字，10秒出片

想做产品介绍、知识科普、种草短视频？直接打字描述场景（比如“猫咪在河边奔跑，电影感风格”），选择视频时长（10/15/25秒）、清晰度（标清/高清）和画幅（横屏/竖屏/正方形），一键生成专业视频，不用手动调任何参数。

2. 图片变视频：上传素材，让静态图动起来

有产品图、风景图、设计素材？上传图片后，补充文字描述想要的动态效果（比如“产品缓慢旋转展示，背景渐变”），就能生成连贯视频，适合电商产品展示、场景复刻，风格和图片保持一致。

3. 定制角色视频：打造专属虚拟形象

想有专属虚拟IP、品牌形象？上传一段不含真人的参考视频，就能生成该角色在不同场景的视频（比如让虚拟代言人在门店介绍产品），还能控制角色出现的时间和位置，重复复用不重样。

4. 批量生成+自动通知：高效不费心

需要一次做几十上百条视频？提交需求后不用盯着等，系统后台自动处理，生成完成后会通过你设置的方式通知你，视频自动备份，随时查看下载，批量产出也能保证画质和效率。

四、4大落地场景：不管你是谁，都能靠视频变现

1. 跨境电商商家：生成产品多角度展示视频、场景化种草视频，不用搭建实景拍摄，适配TikTok、亚马逊等平台，转化率直接提升；
2. 自媒体创作者：批量产出知识科普、书单分享、短视频素材，1天能做几十条，轻松维持日更，抢占平台流量；
3. 品牌营销：定制品牌专属虚拟形象，制作宣传短片、节日营销视频，风格统一不重样，提升品牌曝光度；
4. 企业培训：把文字手册、PPT变成生动的动画视频，不同岗位可定制专属内容，员工学习更高效，培训成本大减。

五、平台背书+限时福利：零风险试错，放心用！

靠谱保障，用得安心：

• 稳定性强：99.9%时间正常可用，国内直接连接，不会卡顿中断；
• 服务贴心：有24小时在线客服，遇到问题随时解决，不用自己琢磨；
• 生态完善：生成的视频自动存储，还能对接流量分析工具，帮你优化视频效果。

限时免费福利，手慢无：

新用户注册就送免费视频生成额度，无套路、无强制消费，个人和企业都能领：

• 免费额度：文本生视频、图片变视频功能都能试；
• 邀请福利：邀请好友注册，有机会得返现，永久有效！

点击直达开通：ACE Data Platform Sora 2 API 免费领额度

结语

2026年流量风口就在视频端，而ACE Data Platform Sora 2 API 让“0代码、低成本、批量出高质量视频”成为现实！不管你是想靠短视频变现的自媒体人，还是想降本增效的电商商家、企业负责人，都能轻松解锁视频创作超能力。

现在领免费额度，零风险试错，1分钟就能做出第一条电影级视频，抢占流量红利！有任何疑问，直接联系客服就能获取一对一指导～

还在为图片创作发愁？找图怕侵权、请设计师1张图要花几百块、AI生成模糊不清、复杂工具半天学不会？别让技术和成本挡住你的创意！

ACE Data Platform 重磅推出 SeeDream 图像生成专属集成方案，把登顶国际榜单的AI生图能力变成“傻瓜式工具”——不用写1行代码、不用懂设计技巧，打字描述、上传图片就能生成4K电影级高清图，新用户直接送免费额度，个人创作、企业批量产出全搞定！专属开通链接：ACE Data Platform SeeDream 免费领额度

一、核心优势：为什么选ACE集成SeeDream？

对比普通生图工具，ACE专属方案精准戳中痛点，新手也能秒上手：

1. 0门槛操作：全程可视化界面，不用懂任何技术，打字说话就能生图，1分钟出结果；
2. 4K高清画质：支持超高清图片生成，细节拉满，印刷、大屏展示都够用，比普通工具清晰2倍；
3. 3大核心功能：文本生图、图片编辑、组图生成，覆盖所有图片需求，中文描述也能精准识别；
4. 稳定不卡顿：国内直接连接，99.9%可用率，批量生成几十上百张也不中断；
5. 省心又省钱：生成图片自动备份，成本比请设计师低90%，还送免费额度，零风险试错。

二、3步免费开通：1分钟解锁生图超能力

开通流程简单到离谱，不用复杂审核，人人可领免费额度：

1. 点击专属链接：ACE Data Platform SeeDream 开通页；
2. 点击页面“Acquire”按钮，没注册的话简单填信息注册登录，自动返回开通页；
3. 开通成功后，系统直接送免费额度，立马就能开始生成图片。

三、核心功能：3种玩法，满足所有图片需求

1. 文本生图：打字描述，秒出高清图

想要产品图、插画、海报、表情包？直接用中文描述画面（比如“日系清新风格的咖啡杯，白色背景，4K高清”），选好尺寸（横屏/竖屏/正方形），一键生成专业图片，不用手动调任何参数。

2. 图片编辑：上传素材，想改就改

有现成图片想优化？上传图片后，用文字说明修改需求（比如“把衣服材质换成透明玻璃，保留人物姿势”“去除背景，换成蓝色渐变”），AI自动适配风格，修改效果自然不生硬。

3. 组图生成：一次出一套，内容相关不重样

需要系列配图、多场景展示图？输入核心主题（比如“小红书养生图文系列，统一卡通风格”），系统会生成一组内容关联、风格统一的图片，适合自媒体连载、产品多维度展示。

4. 批量生成+自动通知：高效不费心

需要大量图片？提交需求后不用盯着等，系统后台自动处理，生成完成后会及时通知你，图片自动保存，随时查看下载，批量产出也能保证画质一致。

四、5大落地场景：不管你是谁，都能靠图提效

1. 电商商家：生成产品白底图、场景化种草图、详情页配图，不用搭建实景拍摄，转化率直接提升；
2. 自媒体创作者：批量产出封面图、表情包、知识卡片，1天能做几十套，轻松维持日更，抢占平台流量；
3. 品牌/设计师：快速生成LOGO初稿、海报方案、活动视觉图，节省创意时间，还能定制专属风格；
4. 企业办公：把PPT、文字手册变成生动插图，制作培训课件、宣传物料，不用等设计部门排期；
5. 个人用户：生成旅行打卡图、社交头像、节日祝福图，创意不限，想怎么玩就怎么玩。

五、平台背书+限时福利：放心用，不踩坑

靠谱保障，用得安心：

• 技术硬核：SeeDream模型拿下国际生图榜单第一，中文理解能力超强，指令执行超精准；
• 服务贴心：ACE Data Platform提供24小时在线客服，遇到问题随时解决，不用自己琢磨；
• 生态完善：生成的图片可直接对接流量分析工具，还能一键分享到社交平台，创作传播一步到位。

限时免费福利，手慢无：

新用户注册就送 免费图片生成额度，无套路、无强制消费，个人和企业都能领

点击直达开通：ACE Data Platform SeeDream 免费领额度

结语

2026年，好图片就是流量密码！ACE Data Platform × SeeDream 让“0代码、低成本、批量出4K高清图”成为现实，不管你是想省时间的自媒体人、想降本增效的商家，还是爱创意的普通人，都能轻松解锁图片创作超能力。

现在领免费额度，零风险试错，1分钟就能做出第一张专业级图片，抢占流量红利！有任何疑问，直接联系客服就能获取一对一指导～

更有海量prompt供大家直接使用，示例如下：

电商营销专属：产品白底图精准模板（直接复制替换）

适配淘宝、京东、亚马逊、拼多多等主流电商平台，满足主图/详情页/活动报名要求，纯白背景（RGB 255,255,255）、无阴影、无水印、细节清晰，直接替换 [ ] 内容即可生成可用图！

一、3C数码类

1. 手机/平板：「4K高清，[产品型号，如：iPhone 16 Pro]，纯白色背景，正面朝上平放，屏幕亮屏展示默认壁纸，边框无反光，无多余配件，800x800像素，符合淘宝主图规范」
2. 耳机/音箱：「4K高清，[产品名称，如：无线降噪耳机]，纯白色背景，耳机主体呈佩戴状态摆放（或对称平放），展示充电盒+耳机全套，细节纹理清晰，无阴影，1000x1000像素，适配亚马逊主图」
3. 小家电（吹风机/剃须刀）：「4K高清，[产品名称，如：负离子吹风机]，纯白色背景，机身直立摆放，展示开关、风嘴等核心部件，无电线缠绕，光线均匀，600x600像素，适合拼多多详情页」
4. 数码配件（充电器/数据线）：「4K高清，[产品名称，如：65W氮化镓充电器]，纯白色背景，充电器+数据线自然摆放（数据线呈弧形），展示接口细节，无多余装饰，800x800像素，符合京东主图要求」

二、美妆护肤类

1. 瓶罐类（面霜/精华）：「4K高清，[产品名称，如：玻尿酸保湿面霜]，纯白色背景，瓶身直立摆放，正面朝向镜头，标签文字清晰可辨，无瓶盖脱落，光线柔和无反光，800x800像素，适配淘宝主图」
2. 彩妆类（口红/眼影盘）：「4K高清，[产品名称，如：哑光雾面口红]，纯白色背景，口红旋出1/3长度，膏体颜色均匀，外壳无划痕，单独摆放（眼影盘需开盖展示内格颜色），1000x1000像素，符合亚马逊要求」
3. 面膜类（片状/涂抹式）：「4K高清，[产品名称，如：补水面膜]，纯白色背景，单片面膜平铺展开（涂抹式面膜需展示罐身+挖勺），无褶皱，包装文字清晰，600x600像素，适合拼多多详情页」
4. 美妆工具（化妆刷/粉扑）：「4K高清，[产品名称，如：10支化妆刷套装]，纯白色背景，刷子整齐排列（刷头朝左/右），展示刷毛细节，无掉毛，手柄直立无倾斜，800x800像素，适配京东主图」

三、服装鞋帽类

1. 上衣/裤子：「4K高清，[产品名称，如：纯棉宽松T恤]，纯白色背景，衣物平铺拍摄（或用模特架支撑），正面展示，无褶皱，颜色还原准确，无吊牌外露，1000x1000像素，符合淘宝主图规范」
2. 鞋子（运动鞋/皮鞋）：「4K高清，[产品名称，如：透气运动鞋]，纯白色背景，单只鞋子斜45°摆放（或两只对称摆放），展示鞋型、鞋底纹路，无鞋带松散，光线均匀，800x800像素，适配亚马逊主图」
3. 配饰（包包/围巾）：「4K高清，[产品名称，如：帆布托特包]，纯白色背景，包包自然撑开（内置填充物保持形状），展示开口、肩带细节，无污渍，600x600像素，适合拼多多详情页」
4. 内衣/袜子：「4K高清，[产品名称，如：无痕内裤]，纯白色背景，衣物平铺无褶皱，颜色均匀，无标签外露，单独摆放（袜子可成对叠放），800x800像素，符合京东主图要求」

四、家居日用类

1. 厨具类（锅具/餐具）：「4K高清，[产品名称，如：不粘平底锅]，纯白色背景，锅具直立摆放（或平铺展示锅底），无油污，手柄无松动，展示锅口边缘细节，1000x1000像素，适配淘宝主图」
2. 家纺类（床单/枕套）：「4K高清，[产品名称，如：全棉印花床单]，纯白色背景，床单平铺展开，图案居中展示，无褶皱，颜色还原准确，800x800像素，符合亚马逊要求」
3. 清洁用品（洗衣液/洗洁精）：「4K高清，[产品名称，如：天然植物洗衣液]，纯白色背景，瓶身直立摆放，正面朝向镜头，标签文字清晰，无漏液痕迹，600x600像素，适合拼多多详情页」
4. 收纳用品（收纳盒/衣架）：「4K高清，[产品名称，如：抽屉式收纳盒]，纯白色背景，收纳盒开盖展示内部隔层，无变形，颜色均匀，单独摆放（衣架可成组排列），800x800像素，适配京东主图」

五、食品饮料类

1. 包装食品（零食/饼干）：「4K高清，[产品名称，如：无蔗糖饼干]，纯白色背景，包装正面朝向镜头，文字图案清晰，无破损、无胀气，单独摆放（多包可整齐排列），800x800像素，符合淘宝主图规范」
2. 瓶装饮料（果汁/矿泉水）：「4K高清，[产品名称，如：鲜榨橙汁]，纯白色背景，瓶身直立摆放，标签居中，液体颜色均匀，无沉淀物，光线柔和无反光，1000x1000像素，适配亚马逊主图」
3. 生鲜食品（水果/蔬菜）：「4K高清，[产品名称，如：进口车厘子]，纯白色背景，3-5颗果实自然摆放，展示果形、色泽，无腐烂、无杂质，600x600像素，适合拼多多详情页」
4. 干货特产（坚果/红枣）：「4K高清，[产品名称，如：原味巴旦木]，纯白色背景，坚果去壳+带壳组合摆放（或展示包装+倒出的坚果），无受潮，颗粒饱满，800x800像素，符合京东主图要求」

六、跨境电商专属（亚马逊/速卖通）

1. 通用模板1：「High-resolution 4K, [Product Name, e.g.: Wireless Bluetooth Earbuds], pure white background (RGB 255,255,255), product placed vertically, front facing the camera, no shadows or reflections, all details clearly visible, 1000x1000 pixels, meeting Amazon main image requirements」
2. 通用模板2：「4K ultra HD, [Product Name, e.g.: Matte Lipstick], pure white background, product displayed alone without extra accessories, labels and logos clearly legible, even lighting, 1200x1200 pixels, suitable for AliExpress main image」
3. 复杂产品模板：「4K high definition, [Product Name, e.g.: 10-in-1 Makeup Brush Set], pure white background, brushes arranged neatly in a row, brush hair details visible, no shedding, 1000x1000 pixels, compliant with Amazon product image guidelines」

模板使用小贴士

1. 像素建议：淘宝/京东主图推荐800x800像素，亚马逊建议1000x1000像素（支持缩放），拼多多可600x600像素（兼顾加载速度）；
2. 光线要求：模板中已包含“光线均匀”“无反光”等关键词，生成时自动适配，无需额外添加；
3. 产品摆放：按模板描述的“直立”“平铺”“斜45°”摆放，确保主体突出，符合电商平台审核规范；
4. 批量生成：如需批量制作同系列产品白底图，可保持模板结构不变，仅替换产品名称和核心特征，保证风格统一。

直接复制模板到 ACE Data Platform SeeDream 生成页，一键生成符合平台要求的4K高清白底图，无需专业摄影和修图，成本直降90%！

还在为短视频愁到脱发？外包1条视频花几百，剪辑软件学不会，AI生成要么卡顿模糊，要么画面和需求完全脱节？2026年视频流量风口，别让“不会做”挡住你的曝光！

ACE Data Platform 联合 SeeDance 推出 AI视频生成神器——不用写脚本、不用学剪辑，输入1句话描述或上传1张图片，就能生成高清短视频。支持文本生视频、图生视频首帧/首尾帧精准控制，新用户注册即享免费体验，单次生成成本低至几元，个人、商家、企业都能轻松拿捏！专属开通链接：ACE Data Platform SeeDance 立即体验

一、3个真相，戳中所有视频创作者的痛

1. 不是你没创意，是传统工具太复杂：写脚本、找素材、调参数、做剪辑，一套流程下来，创意早没了；
2. 不是AI不好用，是普通工具不精准：描述半天生成“四不像”，画面卡顿、人物动作怪异，根本没法用；
3. 不是视频贵，是外包溢价太高：专业团队1条视频要价上千，小成本创作者根本负担不起。

而ACE × SeeDance 直接把复杂流程“打包简化”，让你不用管技术，只专注创意，5分钟就能从“想法”变成“成片”。

二、核心亮点：为什么它能让新手秒变大神？

1. 1句话/1张图，创意直接落地

不用纠结镜头、帧率、转场，用大白话描述需求就行。比如“3C数码产品，无线耳机360度旋转展示，白色背景，时长8秒”，或上传产品图+一句“让这张图动起来，展示开关使用效果”，AI自动生成专业视频。

2. 3种生成模式，覆盖所有场景

• 文本生视频：纯文字描述剧情、风格、时长，适合种草短视频、知识科普、剧情片段；
• 图生视频首帧：上传图片当开头，描述动态效果，让静态产品“活”起来，适合产品展示；
• 图生视频首尾帧：指定开头和结尾画面，AI自动补全中间过渡，适合完整剧情、产品全方位展示。

3. 高清稳定，成本低到离谱

生成视频均为720P+高清画质，画面流畅无卡顿，国内直连节点，生成成功率99.9%。单次生成成本比外包低90%，不用承担设备、人工成本，试错成本几乎为零。

4. 风格自由定，适配全平台

电影感、日系清新、国潮、商务简约、卡通动画等风格一键切换，支持自定义时长（3-60秒）、画幅（9:16竖屏/16:9横屏/1:1正方形），抖音、小红书、视频号、跨境平台全适配。

三、真实案例：普通商家怎么用它涨流量？

深圳一家美妆小店老板，之前每月花2000元请达人拍3条产品视频，转化率平平。用ACE × SeeDance后，每天花10分钟，用文本生视频功能批量生成10条产品使用短视频，内容涵盖“精华液上脸效果”“口红显色展示”“眼影叠涂教程”。

结果1个月后：小红书搜索相关关键词排名冲进前10，到店顾客30%来自视频种草，营销成本降低80%，转化率提升2倍。老板说：“不用等达人排期，自己想拍就拍，内容更贴合店铺调性，效果反而更好。”

四、可直接复制的爆款提示词：4大场景，拿来就用

👉 电商带货类（替换【】内容）

1. 美妆产品：“【哑光口红】，镜头从膏体特写缓慢拉到完整口红，展示旋出、上色过程，暖光氛围，无多余背景，时长6秒，竖屏9:16，适合抖音种草”
2. 家居用品：“【折叠晾衣架】，展示从收纳状态展开的全过程，动作流畅，突出‘省空间’优势，白色背景，时长10秒，横屏16:9，适合详情页”
3. 食品饮料：“【气泡水】，镜头对准瓶口，展示气泡涌出的动态效果，冰爽色调，背景有少量冰块点缀，时长5秒，正方形1:1，适合小红书”

👉 自媒体创作类

1. 知识科普：“主题‘职场沟通3个技巧’，简约动画风格，文字要点+动态图标配合出现，语速适中，时长15秒，横屏16:9，无多余装饰”
2. 生活vlog：“记录【周末露营】，镜头从帐篷外缓慢推进，展示草地、阳光、露营装备，治愈系风格，时长8秒，竖屏9:16，有轻微风声背景音”
3. 剧情短片：“情侣日常，女生递奶茶给男生，男生微笑接过，暖色调，镜头跟随动作移动，时长7秒，竖屏9:16，适合视频号”

👉 图生视频专属

1. 图生首帧：“以上传的【连衣裙图片】为首帧，模特穿着裙子缓慢转身，展示裙摆飘动效果，背景简约纯色，时长9秒，720P画质，竖屏9:16”
2. 图生首尾帧：“以第一张【笔记本电脑正面图】为首帧，第二张【电脑开机显示桌面图】为尾帧，中间展示开盖、开机的连贯动作，商务风，时长12秒，横屏16:9”

👉 企业办公类

1. 培训视频：“【Excel数据透视表】使用教程，屏幕录制风格，突出鼠标操作步骤，配合文字提示，时长18秒，横屏16:9，简洁清晰”
2. 宣传短片：“企业办公环境展示，镜头从门口推进，展示开放式工位、员工协作场景，科技感风格，冷色调，时长15秒，720P画质”

五、1分钟开通：新手也能快速上手

1. 点击专属链接：ACE Data Platform SeeDance 开通页；
2. 点击“Acquire”按钮，未注册用户完成简单注册登录，自动返回开通页；
3. 开通成功后，即可使用免费体验机会，输入提示词就能生成视频。

六、靠谱保障+真实福利，放心用不踩坑

安心保障

• 技术背书：SeeDance视频生成模型，画面流畅度、指令精准度行业领先，中文理解无偏差；
• 服务贴心：24小时在线客服，遇到问题随时响应，不用自己琢磨技术细节；
• 生态完善：生成视频自动存储，支持一键下载、分享，对接流量分析工具，创作-传播一步到位。

点击直达开通：ACE Data Platform SeeDance 立即体验

结语

现在做视频，拼的不是技术，是创意落地的速度。ACE Data Platform × SeeDance 把视频制作门槛拉到最低，让你不用学剪辑、不用找外包，1句话就能出专业短视频。

不管你是想省成本的电商商家、想日更的自媒体人，还是要做企业宣传的负责人，现在开通就能抢占视频流量风口。免费体验机会有限，赶紧点击链接，5分钟搞定你的第一条爆款视频！

2026年流量主战场已锁定视频端！小红书15秒种草视频10万+赞、抖音30秒品牌故事破百万播放、视频号直播切片单日引流500+精准客资… 但90%想靠视频变现的人，都被这些难题卡住：

• 专业剪辑要学3个月，新手望而却步；
• 找团队拍1条商业视频花2000+，中小商家扛不住；
• 批量产出就掉画质，同质化严重没流量；
• AI生成视频参数复杂+网络受限，劝退99%开发者

别慌！刷屏创作者圈的「视频量产神器」——Veo API来了！AI驱动的视频生成与编辑API，让你0专业门槛、低成本批量产出高清商业级视频，更有Ace Data Platform生态加持（专属对接链接：Ace Data Platform官网），稳定省心，个人创作、企业部署全hold住！

一、4大核心能力封神！Veo凭什么成生产力救星？

直接把视频制作效率拉到天花板，全网创作者疯狂跟风的硬实力：

1. 文本/图片一键转视频，小白也能1分钟出片
   输入文字脚本、上传产品图/素材图，Veo自动匹配场景、添加转场特效、生成字幕和背景音乐，无需手动调参！种草视频、产品介绍、知识科普全搞定，1分钟干完别人1天的活。

2. 4K超清画质+多风格适配，商业级质感拉满
   支持4K/1080P超清输出，色彩还原度超高、细节无模糊！ins风、国潮风、科技感、治愈系等100+风格模板任选，还能自定义品牌色调、水印，助力打造专属IP，质感碾压同行。

3. 智能剪辑+批量生成，效率直接翻10倍
   批量导入脚本生成多条视频，自动规避重复片段；智能截取高光，精准适配小红书（15s）、抖音（30s）、视频号（60s）等平台时长要求，无需二次修改，日更不熬夜。

4. 多模态交互+高兼容性，开发10分钟接入
   支持文本、图像多模态指令，可对接自有素材库；适配Python、JavaScript等全主流编程语言，提供详细开发文档和示例代码，新手开发者也能快速上手调试。

二、5大落地场景，覆盖从个人到企业全需求

不同用户都能找到核心价值，流量变现、降本增效一把抓：

1. 自媒体创作：批量生成知识科普、书单/影单分享、短视频封面，轻松维持日更，抢占流量红利，不用熬夜剪辑！

2. 电商营销：产出产品多角度展示、场景化种草、直播切片视频，无需实景拍摄，营销素材成本直降90%，转化率提升3倍+！

3. 企业培训：文字手册、PPT一键转动画培训视频，生动易懂，员工学习效率翻倍；还能批量生成不同岗位定制化内容！

4. 品牌营销：批量产出品牌宣传、节日营销、活动预热视频，风格统一覆盖全平台，快速提升品牌曝光度和用户记忆点！

5. 娱乐开发：开发视频变装、AI换脸、老视频修复等趣味APP功能，强互动性拉满用户留存率和分享欲，打造爆款应用！

三、避坑指南！成本直降1/3

商业部署/大规模调用：Ace Data Platform协同方案（强推！）
通过专属通道接入（链接：Veo API专属对接页），3大优势解决所有痛点：

• 成本更低：阶梯定价+失败调用不计费，比官方直连节省30%+成本，中小商家无压力；
• 网络更稳：国内直连专属节点，无需额外配置代理，API可用性99.9%，批量生成不卡顿、不中断；
• 生态更全：联动平台其他API，可以实现更高效率生成视频，一站式解决您制作视频的所有步骤。

四、3步快速接入，解锁视频量产超能力

1. 注册Ace Data Platform账号，进入Veo API专属对接页，领取专属API Key；
2. 参考多语言示例代码（含Python、JavaScript等），按需配置文本转视频、图片转视频、智能剪辑等参数；
3. 发起调用并对接自有系统/创作工具，生成视频自动存储至平台云空间！

五、限时福利！手慢无！

新用户注册Ace Data Platform，直接解锁Veo API免费体验额度！
无套路！个人/企业通用 | 零成本试错 | 即领即用！
点击直达领取：Veo API免费体验通道

2026视频流量风口，拼的就是「量产能力」+「内容质感」！Veo API帮你跳过专业门槛、砍掉高成本，Ace Data Platform生态更让视频创作从“盲目产出”升级为“精准变现”～

不管你是想靠短视频变现的自媒体人，还是想降本增效的电商商家、企业营销人员，这波免费体验机会千万别错过！先体验再决策，零风险开启视频量产爆发之旅！

最近被谷歌新发布的 Nano Banana（Gemini 2.5 Flash Image）图像生成模型 霸屏了。

从手办秒变真人级 Cosplay，到一键统一多图风格，从个性化头像到产品概念设计，甚至连静态画作都能一键生成电影级动态分镜——这波 AI 生图浪潮，真的在重新定义创作！

Ace Data Cloud 平台 https://platform.acedata.cloud 现也推出 Nano Banana API：价格：约 ¥0.10/张，成本相比官方直接省一半，性能效果毫不打折。是更快、更稳、更省钱的图片生产线

Nano Banana 强在哪？

它最厉害的地方，是能轻松实现 高精度的一致性生成。
无论是换背景、改风格、调表情，还是处理复杂动作与服装，过渡都非常自然，效果高度统一，几乎看不出 AI 生成的痕迹！

超实用的玩法示例

1. 2D 图片转 3D 手办

当前最火的出圈玩法！

指令：生成一幅图片中角色的商品化模型，环境写实。模型放电脑桌上，使用圆形亚克力底座。电脑屏幕显示建模过程，旁边放置印有原图的 BANDAI 包装盒。

2. 产品内部结构解析

提示词：超详细的产品爆炸视图，金属零件和电子元件漂浮在半空中，完美排列，揭示内部结构，未来主义技术美学，8K 分辨率，柔和的电影照明，高度逼真。背景是纯白色。

3. 老照片修复

提示词：请修复这张充满划痕的黑白老照片。移除所有污点和破损，大幅提升清晰度，并进行自然、逼真的上色。

4. 多元素组图 / 电商产品植入

提示词：一位模特站在一辆白色的车前面摆拍，场景为街区路面，两边是建筑。她穿着黑色连衣裙和白色高跟鞋，一手拎着白色的包。

还有更多实用场景：一键换装/换表情/换动作、多角度镜头、人物合影、表情包九宫格、模特 OOTD 服装平铺展示、手稿转 3D 实物图、建筑等轴测建模、地图转实景解析……统统都能高效完成！

在展示了 Nano Banana 如此多令人惊艳的玩法之后，你可能会想：这么强大的能力，接入起来一定很复杂，成本也很难控制吧？
无论是 AI 产品的开发者想要快速集成，还是个人用户希望直接体验，Ace Data Cloud 都让这一切变得简单、可控且经济。

价格

说到价格，Ace Data Cloud 绝对是你的性价比之选：

• Google 官方：约美元 $0.039/张，按 $1 ≈ ¥7.2 计算，人民币大约 ¥0.28/张。
• AceDataCloud：统一 ¥0.10/张。

另外并发支持更宽裕，响应更稳定，提供专属客服，7×24 小时可用性保障，具体价格与配额请见：https://platform.acedata.cloud/services/nano-banana。

快速接入，立即体验高品质低成本图像生成！

我们提供简洁的 API 和完整的开发文档，助你快速集成到既有工作流或新产品。

• 开发集成文档：https://platform.acedata.cloud/documents/nano-banana-images-integration
• 立即购买与使用：https://platform.acedata.cloud/documents/nano-banana-images-integration
• 技术支持与咨询：随时联系我们的技术团队：https://platform.acedata.cloud/support

下面是样例调用说明，轻松一个 API 就能得到你想要的效果：

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/nano-banana/images' \
  -H 'authorization: Bearer {token}' \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -d '{
    "action": "generate",
    "prompt": "A photorealistic close-up portrait of an elderly Japanese ceramicist with deep, sun-etched wrinkles and a warm, knowing smile. He is carefully inspecting a freshly glazed tea bowl. The setting is his rustic, sun-drenched workshop. The scene is illuminated by soft, golden hour light streaming through a window, highlighting the fine texture of the clay. Captured with an 85mm portrait lens, resulting in a soft, blurred background (bokeh). The overall mood is serene and masterful. Vertical portrait orientation."
  }'

返回结果：

1
2
3
4
5
6
7
8
9
10
11

{
  "success": true,
  "task_id": "056f0589-a3dd-4ec2-8440-ad61f5038dfa",
  "trace_id": "c48de83f-0077-426e-b02b-ff1d58179064",
  "data": [
    {
      "prompt": "A photorealistic close-up portrait of an elderly Japanese ceramicist with deep, sun-etched wrinkles and a warm, knowing smile. He is carefully inspecting a freshly glazed tea bowl. The setting is his rustic, sun-drenched workshop. The scene is illuminated by soft, golden hour light streaming through a window, highlighting the fine texture of the clay. Captured with an 85mm portrait lens, resulting in a soft, blurred background (bokeh). The overall mood is serene and masterful. Vertical portrait orientation.",
      "image_url": "https://platform.cdn.acedata.cloud/nanobanana/69790adb-c85d-4362-ad9e-0c9ba4352cf4.png"
    }
  ]
}

其中 image_url 就是 Nano Banana 生成的的图片，永久可访问。

总结

好了，以上就是 Ace Data Cloud 的 Nano Banana API 的介绍，快来试试吧！

Google Gemini 是一款非常强大的 AI 对话系统，只要输入提示词，就能在短短几秒内生成流畅自然的回复。Gemini 都能提供令人惊叹的智能协助，极大地提高了人类的工作效率和创造力。

本文档主要介绍 Gemini Chat Completion API 操作的使用流程，利用它我们可以轻松使用官方 Gemini 的对话功能。

申请流程

要使用 Gemini Chat Completion API，首先可以到 Gemini Chat Completion API 页面点击「Acquire」按钮，获取请求所需要的凭证：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

接下来就可以在界面上填写对应的内容，如图所示：

在第一次使用该接口时，我们至少需要填写三个内容，一个是 authorization，直接在下拉列表里面选择即可。另一个参数是 model， model 就是我们选择使用 Gemini 官网模型类别，这里我们主要有 6 种模型，详情可以看我们提供的模型。最后一个参数是messages，messages是我们输入的提问词数组，它是一个数组，表示可以同时上传多个提问词，每个提问词包含了 role 和 content，其中 role 表示提问者的角色，我们提供了三种身份，分别为 user 、assistant、system 。另一个 content 就是我们提问的具体内容。

同时您可以注意到右侧有对应的调用代码生成，您可以复制代码直接运行，也可以直接点击「Try」按钮进行测试。

调用之后，我们发现返回结果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

{
  "id": "chatcmpl-20251122212413908150493uPhjTUO9",
  "model": "gemini-2.5-pro",
  "object": "chat.completion",
  "created": 1763817866,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I am a large language model, trained by Google.",
        "reasoning_content": "**My Reasoning: Answering the User's Question**\n\nOkay, here's how I'm going to approach answering the user's question, \"What model are you?\". The core is to be direct and informative. First, I have to be clear about my origin. Then, I need to make sure the explanation is accessible, given that the user may not be familiar with technical jargon. I need to explain what a \"large language model\" actually *does*, and provide relatable examples. I know the user might be looking for a specific name, like other models have, so I'll address that directly and then wrap it up with an invitation to continue.\n\nSo, here's my plan:\n\n1.  **Lead with the key info:** I'll begin by stating that I am a large language model created by Google. That is the fundamental, most critical piece of the puzzle.\n2.  **Define the buzzword:** Then, I'll explain that \"large language model\" in simple terms. I'll explain what I *do* - process and generate text; how I *do* it - by training on huge amounts of text data; and the *goal* - to be able to communicate like a human.\n3.  **Provide context:** After that, to make the concept even clearer, I'll provide a list of examples of my capabilities. I'll mention things like answering questions, summarizing texts, writing stories, translating languages, and brainstorming ideas.\n4.  **Acknowledge the lack of a personal name:** I'll anticipate the likely question about a model name (like ChatGPT) by clearly stating that I don't have a personal name and that it's best to think of me as an AI assistant from Google.\n5.  **End with an invitation:** Lastly, I'll end with a simple, friendly question to invite further interaction and to guide the conversation.\n\nWith this approach, I am confident I can successfully answer this important question.\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 932,
    "total_tokens": 940,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 8,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 921
    },
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": null,
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  }
}

返回结果一共有多个字段，介绍如下：

• id，生成此次对话任务的 ID，用于唯一标识此次对话任务。
• model，选择的 Gemini 官网模型。
• choices，Gemini 针对提问词给于的回答信息。
• usage：针对本次问答对 token 的统计信息。

其中 choices 是包含了 Gemini 的回答信息，它里面的 choices 是 Gemini回答的具体信息，可以发现如图所示。

可以看到，choices 里面的 content 字段包含了 Gemini 回复的具体内容。

流式响应

该接口也支持流式响应，这对网页对接十分有用，可以让网页实现逐字显示效果。

如果想流式返回响应，可以更改请求头里面的 stream 参数，修改为 true。

修改如图所示，不过调用代码需要有对应的更改才能支持流式响应。

将 stream 修改为 true 之后，API 将逐行返回对应的 JSON 数据，在代码层面我们需要做相应的修改来获得逐行的结果。

Python 样例调用代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

import requests

url = "https://api.acedata.cloud/gemini/chat/completions"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "gemini-2.5-pro",
    "messages": [{"role":"user","content":"Hello,What model are you?"}],
    "stream": True
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

输出效果如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

data: {"id": "chatcmpl-20251122214038810722821kNjUTjtr", "object": "chat.completion.chunk", "created": 1763818842, "model": "gemini-2.5-pro", "system_fingerprint": null, "choices": [{"delta": {"content": "", "role": "assistant"}, "logprobs": null, "finish_reason": null, "index": 0}], "usage": null}

data: {"id": "chatcmpl-20251122214038810722821kNjUTjtr", "object": "chat.completion.chunk", "created": 1763818842, "model": "gemini-2.5-pro", "system_fingerprint": null, "choices": [{"delta": {"reasoning_content": "**Define My Nature**\n\nMy thinking has started. The user wants to know my nature, asking a direct \"what are you?\" The initial step was straightforward: identifying the query. Now, I recall my fundamental identity: I'm a large language model. This is the core truth I aim to convey.\n\n\n"}, "logprobs": null, "finish_reason": null, "index": 0}], "usage": null}

data: {"id": "chatcmpl-20251122214038810722821kNjUTjtr", "object": "chat.completion.chunk", "created": 1763818842, "model": "gemini-2.5-pro", "system_fingerprint": null, "choices": [{"delta": {"reasoning_content": "**Refining My Response**\n\nI've added the crucial information that I'm trained by Google to the basic \"large language model\" identity. My next step is considering what being a \"large language model\" actually entails, so I can explain my core capabilities. I'm focusing on providing context without going into specific technical details or model names. I want to convey my function in a way the user can easily understand.\n\n\n"}, "logprobs": null, "finish_reason": null, "index": 0}], "usage": null}

data: {"id": "chatcmpl-20251122214038810722821kNjUTjtr", "object": "chat.completion.chunk", "created": 1763818842, "model": "gemini-2.5-pro", "system_fingerprint": null, "choices": [{"delta": {"reasoning_content": "**Confirming Core Identity**\n\nI'm now solidifying my response. The user's query about my model affiliation needs a focused answer. I've pinpointed that \"trained by Google\" is essential, providing key context. I'm resisting the urge to mention any specific model names, as it's not relevant. The aim is to deliver a direct, accurate statement. My goal remains a clear and concise reply, avoiding technical jargon and getting straight to the relevant point.\n\n\n"}, "logprobs": null, "finish_reason": null, "index": 0}], "usage": null}

data: {"id": "chatcmpl-20251122214038810722821kNjUTjtr", "object": "chat.completion.chunk", "created": 1763818842, "model": "gemini-2.5-pro", "system_fingerprint": null, "choices": [{"delta": {"content": "I am a large language model, trained by Google."}, "logprobs": null, "finish_reason": null, "index": 0}], "usage": null}

data: {"id": "chatcmpl-20251122214038810722821kNjUTjtr", "object": "chat.completion.chunk", "created": 1763818842, "model": "gemini-2.5-pro", "system_fingerprint": null, "choices": [{"delta": {}, "logprobs": null, "finish_reason": "stop", "index": 0}], "usage": null}

data: {"id": "chatcmpl-20251122214038810722821kNjUTjtr", "object": "chat.completion.chunk", "created": 1763818842, "model": "gemini-2.5-pro", "system_fingerprint": "", "choices": [], "usage": {"prompt_tokens": 8, "completion_tokens": 527, "total_tokens": 535, "prompt_tokens_details": {"cached_tokens": 0, "text_tokens": 8, "audio_tokens": 0, "image_tokens": 0}, "completion_tokens_details": {"text_tokens": 0, "audio_tokens": 0, "reasoning_tokens": 519}, "input_tokens": 0, "output_tokens": 0, "input_tokens_details": null, "claude_cache_creation_5_m_tokens": 0, "claude_cache_creation_1_h_tokens": 0}}

data: [DONE]

可以看到，响应里面有许多 data ，data 里面的 choices 即为最新的回答内容，与上文介绍的内容一致。choices 是新增的回答内容，您可以根据结果来对接到您的系统中。同时流式响应的结束是根据 data 的内容来判断的，如果内容为 [DONE]，则表示流式响应回答已经全部结束。返回的 data 结果一共有多个字段，介绍如下：

• id，生成此次对话任务的 ID，用于唯一标识此次对话任务。
• model，选择的 Gemini 官网模型。
• choices，Gemini 针对提问词给于的回答信息。

JavaScript 也是支持的，比如 Node.js 的流式调用代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

const options = {
  method: "post",
  headers: {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
  },
  body: JSON.stringify({
    "model": "gemini-2.5-pro",
    "messages": [{"role":"user","content":"Hello,What model are you?"}],
    "stream": true
  })
};

fetch("https://api.acedata.cloud/gemini/chat/completions", options)
  .then(response => response.json())
  .then(response => console.log(response))
  .catch(err => console.error(err));

Java 样例代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

JSONObject jsonObject = new JSONObject();
jsonObject.put("model", "gemini-2.5-pro");
jsonObject.put("messages", [{"role":"user","content":"Hello,What model are you?"}]);
jsonObject.put("stream", true);
MediaType mediaType = "application/json; charset=utf-8".toMediaType();
RequestBody body = jsonObject.toString().toRequestBody(mediaType);
Request request = new Request.Builder()
  .url("https://api.acedata.cloud/gemini/chat/completions")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer {token}")
  .addHeader("content-type", "application/json")
  .build();

OkHttpClient client = new OkHttpClient();
Response response = client.newCall(request).execute();
System.out.print(response.body!!.string())

其他语言可以另外自行改写，原理都是一样的。

多轮对话

如果您想要对接多轮对话功能，需要对 messages 字段上传多个提问词，多个提问词的具体示例如下图所示：

Python 样例调用代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

import requests

url = "https://api.acedata.cloud/gemini/chat/completions"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "model": "gemini-2.5-pro",
    "messages": [{"role":"user","content":"Hello"},{"role":"assistant","content":"Hello there! How can I help you today?"},{"role":"user","content":"What model are you?"}]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

通过上传多个提问词，就可以轻松实现多轮对话，可以得到如下回答：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

{
  "id": "chatcmpl-20251122214426669120974AKFwnJd1",
  "model": "gemini-2.5-pro",
  "object": "chat.completion",
  "created": 1763819072,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "I am a large language model, trained by Google.",
        "reasoning_content": "Okay, here's how I'd approach this, thinking as a sophisticated AI:\n\nFirst, the user is directly querying my core identity: \"What model are you?\" That's a simple, straightforward question. My primary task is to provide accurate and helpful information, so I need to answer this immediately.\n\nRight off the bat, I know the answer. I *am* a large language model. That's my fundamental architecture and operational principle. I'm built on a vast network of connections and trained on a massive dataset.\n\nThen I must add the necessary context. Crucially, I have to provide the source of my training. I *was* trained by Google. That's a key identifier. It provides the user with valuable information about my origin and potential biases (though I'm trained to mitigate them).\n\nNow I must construct the response. My goal is to be factual, concise, and understandable.\n\nThe synthesized response is something like: \"I am a large language model, trained by Google.\"\n\nI have to assess the output: Does it meet the criteria? It's clear. It states what I am, it includes a critical piece of information on my origins, and it avoids jargon. No misleading promises.\n\nFinal verification: Does it actually answer the question? Yes. Is the information correct and truthful? Yes. Is it concise? Absolutely. Is the tone appropriate for any user? Yes. And, finally, this is the standard, approved response. Excellent.\n"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 16,
    "completion_tokens": 265,
    "total_tokens": 281,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 16,
      "audio_tokens": 0,
      "image_tokens": 0
    },
    "completion_tokens_details": {
      "text_tokens": 0,
      "audio_tokens": 0,
      "reasoning_tokens": 254
    },
    "input_tokens": 0,
    "output_tokens": 0,
    "input_tokens_details": null,
    "claude_cache_creation_5_m_tokens": 0,
    "claude_cache_creation_1_h_tokens": 0
  }
}

可以看到，choices 包含的信息与基本使用的内容是一致的，这个包含了 Gemini 针对多个对话进行回复的具体内容，这样就可以根据多个对话内容来回答对应的问题了。

Gemini-3.0 多模态模型

请求样例：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

{
  "model": "gemini-3.0-pro",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "图片的内容是什么？"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.acedata.cloud/qzx2z1.png"
          }
        }
      ]
    }
  ],
  "stream": false
}

样例结果：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

{
    "id": "chatcmpl-20251206001815715692730UVZe38kB",
    "model": "gemini-3.0-pro",
    "object": "chat.completion",
    "created": 1764951548,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "这是一张年轻女性的户外半身人像照片。\n\n以下是图片的主要内容描述：\n\n*   **人物外貌**：照片中的女孩留着一头乌黑柔顺的长直发，五官清秀，皮肤白皙。她面带温柔的微笑，目光注视着镜头。\n*   **穿着打扮**：她穿着一件米白色或浅杏色的泡泡袖上衣，外面搭配着黑色的衣物（看起来像是背带裙或马甲）。\n*   **光影氛围**：阳光从左侧后方照射过来，洒在她的头发上，形成了一圈温暖的金黄色光晕，营造出一种清新、唯美的氛围。\n*   **背景**：背景被虚化处理，可以看出是在户外，身后是一条空旷的路面（柏油路）以及路边的绿色树木。\n\n整体来看，这张照片给人一种甜美、阳光和邻家女孩的感觉。"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 1092,
        "completion_tokens": 1271,
        "total_tokens": 2363,
        "prompt_tokens_details": {
            "cached_tokens": 0,
            "text_tokens": 4,
            "audio_tokens": 0,
            "image_tokens": 0
        },
        "completion_tokens_details": {
            "text_tokens": 0,
            "audio_tokens": 0,
            "reasoning_tokens": 1072
        },
        "input_tokens": 0,
        "output_tokens": 0,
        "input_tokens_details": null,
        "claude_cache_creation_5_m_tokens": 0,
        "claude_cache_creation_1_h_tokens": 0
    }
}

当然你也可以传如视频的链接，具体的输入如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

{
  "model": "gemini-3.0-pro",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "视频的内容是什么？"
        },
        {
          "type": "image_url",
          "image_url": {
            "url": "https://cdn.acedata.cloud/58yioe.mp4"
          }
        }
      ]
    }
  ],
  "stream": false
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

{
    "id": "chatcmpl-20251206002711949677736JC9yL8AE",
    "model": "gemini-3.0-pro",
    "object": "chat.completion",
    "created": 1764952060,
    "choices": [
        {
            "index": 0,
            "message": {
                "role": "assistant",
                "content": "这段视频的内容充满趣味，主要展示了一只**橘猫**在黄昏时分的乡间公路上自信小跑的情景。\n\n具体细节如下：\n\n1.  **画面内容**：\n    *   主角是一只橘色的虎斑猫。\n    *   背景是夕阳西下（或清晨）的时刻，光线金黄柔和。路边有木质栅栏和旷野，远处还有一个行人的剪影。\n    *   镜头采用了低角度拍摄，时而拍摄猫咪迎面跑来，时而拍摄它离去的背影，还有猫咪面部和花纹的特写。\n\n2.  **声音特点（关键点）**：\n    *   视频的配音非常有特色。虽然画面是轻盈的猫咪在跑，但配上的声音却是**沉重且有节奏的马蹄声**（或者是类似木屐/高跟鞋敲击路面的声音）。\n    *   这种声音与画面的反差制造了一种幽默感，仿佛这只猫咪把自己当成了一匹正在驰骋的骏马。\n\n总的来说，这是一个利用音画反差来制造萌点和笑点的宠物视频。"
            },
            "finish_reason": "stop"
        }
    ],
    "usage": {
        "prompt_tokens": 915,
        "completion_tokens": 1423,
        "total_tokens": 2338,
        "prompt_tokens_details": {
            "cached_tokens": 0,
            "text_tokens": 5,
            "audio_tokens": 0,
            "image_tokens": 0
        },
        "completion_tokens_details": {
            "text_tokens": 0,
            "audio_tokens": 0,
            "reasoning_tokens": 1162
        },
        "input_tokens": 0,
        "output_tokens": 0,
        "input_tokens_details": null,
        "claude_cache_creation_5_m_tokens": 0,
        "claude_cache_creation_1_h_tokens": 0
    }
}

从上面可以看出是Gemini 3.0模型可以支持多模态的理解的。

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

• 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
• 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
• 401 invalid_token：Unauthorized, invalid or missing authorization token.
• 429 too_many_requests：Too many requests, you have exceeded the rate limit.
• 500 api_error：Internal server error, something went wrong on the server.

错误响应示例

1
2
3
4
5
6
7
8

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

通过本文档，您已经了解了如何使用 Gemini Chat Completion API 轻松实现官方 Gemini 的对话功能。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

本文将介绍一种 Sora Videos Generation API 对接说明，它是可以通过输入自定义参数来生成Sora官方的视频。

申请流程

要使用 API，需要先到 Sora Videos Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

首先先了解下基本的使用方式，就是输入提示词 prompt、参考图片链接数组 image_urls 以及模型 model，便可获得处理后的结果，具体的内容如下：

可以看到这里我们设置了 Request Headers，包括：

• accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
• authorization：调用 API 的密钥，申请之后可以直接下拉选择。

另外设置了 Request Body，包括：

• model：生成视频的模型，主要有sora-2、sora-2-pro，目前 sora-2、sora-2-pro可以自主选择size、duration参数的视频，其中sora-2-pro可以支持duration为25s的视频，而sora-2只支持10、15秒的视频。
• size：此次视频生成任务的清晰度，分别有 small 、 large。
• image_urls：需要上传的参考图片链接或者Base64编码数组。
• duration：此次视频生成任务的时长，分别有10s、15s、25s，目前只有sora-2-pro支持25s。
• character_start/character_end：角色在画面中的起止位置（0-1），用于控制主体位置。
• orientation：画幅方向，支持 landscape、portrait、square。
• prompt：提示词。
• callback_url：需要回调结果的URL。

选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「Try」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "success": true,
  "task_id": "6bf7fb83-5814-4e3e-a4ad-bfa0c26c0b33",
  "trace_id": "96166698-4b66-478d-a26b-77a7269c9e01",
  "data": [
    {
      "id": "sora-2:task_01k7770rgsevxsmtpbn7xnm5gh",
      "video_url": "https://filesystem.site/gptimage/vg-assets/assets%2Ftask_01k7770rgsevxsmtpbn7xnm5gh%2Ftask_01k7770rgsevxsmtpbn7xnm5gh_genid_0bf958d3-cae7-4298-b7b6-99ae439a1ea6_25_10_10_14_06_975715%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A30%3A38Z&se=2025-10-16T13%3A30%3A38Z&sks=b&skt=2025-10-10T12%3A30%3A38Z&ske=2025-10-16T13%3A30%3A38Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=8ebb0df1-a278-4e2e-9c20-f2d373479b3a&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=jigY6Z5qp8%2BTXYobaW0EAJ4%2Fbx6G7t6V1P0iyDeUq48%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

返回结果一共有多个字段，介绍如下：

• success，此时视频生成任务的状态情况。
• task_id，此时视频生成任务ID。
• trace_id，此时视频生成跟踪ID。
• data，此时视频生成任务的结果列表。
  • id，此时视频生成任务的视频ID。
  • video_url，此时视频生成任务的视频链接。
  • state，此时视频生成任务的状态。

可以看到我们得到了满意的视频信息，我们只需要根据结果中 data 的视频链接地址获取生成的Sora视频即可。

另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：

1
2
3
4
5
6
7
8
9
10
11

curl -X POST 'https://api.acedata.cloud/sora/videos' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "size": "large",
  "duration": 15,
  "orientation": "landscape",
  "prompt": "cat running on the river",
  "model": "sora-2"
}'

图生视频任务

如果想图生视频任务任务， 首先参数image_urls必须传入参考图片链接，就可以指定如下内容：

• image_urls：该图生视频任务采用的参考图链接数组，。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "large",
    "duration": 15,
    "orientation": "landscape",
    "prompt": "cat running on the river",
    "model": "sora-2",
    "image_urls": ["https://cdn.acedata.cloud/11wfp4.png"]
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

点击运行，可以发现会立即得到一个结果，如下：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "success": true,
  "task_id": "dd392ff0-dcb7-4c7a-afd0-9bd4f65c803a",
  "trace_id": "04fd151c-e942-4c1c-a6ab-9a1b1fe54172",
  "data": [
    {
      "id": "sora-2:task_01k777af4hfmg9g7yfvwsc6zws",
      "video_url": "https://filesystem.site/gptimage/vg-assets/assets%2Ftask_01k777af4hfmg9g7yfvwsc6zws%2Ftask_01k777af4hfmg9g7yfvwsc6zws_genid_92bae0c5-1703-4a5f-9d9f-c9ed2f9e7176_25_10_10_14_12_924695%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A37%3A32Z&se=2025-10-16T13%3A37%3A32Z&sks=b&skt=2025-10-10T12%3A37%3A32Z&ske=2025-10-16T13%3A37%3A32Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=5j4dibeaSsDmEka5c%2B9CKHZhRPdqfClQ0tIh03TWXsM%3D&az=oaivgprodscus",
      "state": "succeeded"
    }
  ]
}

可以看到，生成的效果是图生建视频的，结果与上文类似。

角色生成视频任务

如果想角色生成视频任务， 首先参数character_url必须传入创建角色需要的视频链接，注意视频中一定不能出现真人，否则会失败，就可以指定如下内容：

• character_url：创建角色需要的视频链接，注意视频中一定不能出现真人，否则会失败。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

import requests

url = "https://api.acedata.cloud/sora/videos"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "size": "small",
    "duration": 10,
    "orientation": "landscape",
    "prompt": "cat running on the river",
    "character_url": "https://cdn.acedata.cloud/pdidf5.mp4",
    "model": "sora-2",
    "character_end": 3,
    "character_start": 1
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

点击运行，可以发现会立即得到一个结果，如下：

1
2
3
4
5
6
7
8
9
10
11
12

{
  "success": true,
  "task_id": "d9bf5461-29b5-47fd-be90-1fe9197df259",
  "trace_id": "b7992643-9207-40d6-956b-7577728acc67",
  "data": [
    {
      "id": "sora-2:task_01k8ykrztefavaypw6xanw305b",
      "video_url": "https://filesystem.site/cdn/20251101/bee4eeeb4c4660b46dac4548a1ffbc.mp4",
      "state": "succeeded"
    }
  ]
}

可以看到，生成的效果是角色生成视频，结果与上文类似。

异步回调

由于 Sora Videos Generation API生成的时间相对较长，大约需要 1-2 分钟，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成视频的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入相应的参数，具体的内容如图所示：

点击运行，可以发现会立即得到一个结果，如下：

1
2
3

{
  "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea"
}

稍等片刻，我们可以在 https://webhook.site/eb238c4f-da3b-47a5-a922-a93aa5405daa 上观察到生成歌曲的结果，如图所示：

内容如下：

1
2
3
4
5
6
7
8
9
10
11
12

{
    "success": true,
    "task_id": "b8976e18-32dc-4718-9ed8-1ea090fcb6ea",
    "trace_id": "fb751e1e-4705-49ea-9fd4-5024b7865ea2",
    "data": [
        {
            "id": "sora-2:task_01k777hjrbfrgs2060q5zvf2a5",
            "video_url": "https://filesystem.site/gptimage/vg-assets/assets%2Ftask_01k777hjrbfrgs2060q5zvf2a5%2Ftask_01k777hjrbfrgs2060q5zvf2a5_genid_b8e2e5d1-a579-49ca-a21c-cb3869685cce_25_10_10_14_15_147334%2Fvideos%2F00000%2Fsrc.mp4?st=2025-10-10T12%3A38%3A49Z&se=2025-10-16T13%3A38%3A49Z&sks=b&skt=2025-10-10T12%3A38%3A49Z&ske=2025-10-16T13%3A38%3A49Z&sktid=a48cca56-e6da-484e-a814-9c849652bcb3&skoid=aa5ddad1-c91a-4f0a-9aca-e20682cc8969&skv=2019-02-02&sv=2018-11-09&sr=b&sp=r&spr=https%2Chttp&sig=p4aMqXqkP%2FI1IhOVGCB9JL8vUUvfNBBF12ESpKhKXOk%3D&az=oaivgprodscus",
            "state": "succeeded"
        }
    ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

• 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
• 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
• 401 invalid_token：Unauthorized, invalid or missing authorization token.
• 429 too_many_requests：Too many requests, you have exceeded the rate limit.
• 500 api_error：Internal server error, something went wrong on the server.

错误响应示例

1
2
3
4
5
6
7
8

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

通过本文档，您已经了解了如何使用 Sora Videos Generation API 可通过输入提示词以及参考图片来生成视频。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

本文将介绍一种 Producer Audios Generation API 对接说明，它是可以通过输入自定义参数来生成 Producer 官方的音乐。

申请流程

要使用 API，需要先到 Producer Audios Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

想些什么歌曲，可以任意输入一段文字，比如我想生成一个关于圣诞的歌曲，就可以输入 a song for Christmas，如图所示：

可以看到这里我们设置了 Request Headers，包括：

• accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
• authorization：调用 API 的密钥，申请之后可以直接下拉选择。

另外 Request Body 的参数包括：

• action：此次音乐生成任务的行为，生成歌曲是 generate。
• model：创建歌曲采用的模型，目前主要有： FUZZ-2.0 Pro、FUZZ-2.0、FUZZ-2.0 Raw,FUZZ-1.1 Pro、FUZZ-1.0 Pro、FUZZ-1.0、FUZZ-1.1、FUZZ-0.8。
• lyric：歌曲的歌词内容。
• custom：是否采用自定义方式生成歌曲。
• prompt：灵感模式下的提示词。
• title：歌曲标题信息。
• audio_id：参考歌曲 ID，用于续写/翻版等操作。
• continue_at：从指定秒数开始续写歌曲。
• replace_section_start/replace_section_end：替换片段的起止时间，单位秒。
• lyrics_strength：歌词强度，表示歌词在音频生成中的影响程度，可选0-1之间，默认0.7。
• sound_strength：音频提示词强度，可选0.2-1之间，默认0.7。
• cover_strength：翻唱强度 0.2-1之间，默认1。
• weirdness：风格奇特度，可选 0-1之间，默认0.5
• callback_url：需要回调结果的 URL。
• instrumental：是否为无歌词模式。

选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「Try」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "success": true,
  "task_id": "82fd443a-903a-4f18-8028-12d2f8a0a4be",
  "trace_id": "d85839fa-0bb1-42da-a9fc-cd582c29027d",
  "data": [
    {
      "id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d",
      "title": "Untitled",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/a853673e-615c-42ae-bdff-16b1add94861/image/6c947f13-a3c5-4b9c-8609-5639c37cdc2d.jpg",
      "lyric": "[Instrumental]",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/a853673e-615c-42ae-bdff-16b1add94861/audio/6c947f13-a3c5-4b9c-8609-5639c37cdc2d.m4a",
      "video_url": null,
      "image_id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d",
      "topic": null,
      "seed": "2450882164",
      "sound": "A song for Christmas",
      "created_at": "2025-12-30T17:18:23.232911Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "181.3014058956916"
    }
  ]
}

返回结果一共有多个字段，介绍如下：

• success，此时音乐生成任务的状态情况。
  • data，此次音乐任务的结果
    • id，此时音乐生成任务的 ID。
    • sound，此时音乐生成任务的提示词。
    • seed，此时音乐生成任务的种子值。
    • audio_url，此时音乐生成任务的音频链接。
    • image_url，此时音乐生成任务的封面链接。
    • image_id，此时音乐生成任务的封面ID。
    • state，此时音乐生成任务的状态。
    • duration，此时音乐的时长信息。
    • progress，此时音乐任务的进度值。
    • model，此时音乐生成任务采用的模型信息。
    • lyric，此时音乐生成任务的歌词信息。

可以看到我们得到了想生成的音乐信息，我们只需要根据结果中 data 的音乐链接地址获取生成的 Producer 音乐即可。

另外如果想生成对应的对接代码，可以直接复制生成，例如 CURL 的代码如下：

1
2
3
4
5
6
7
8
9

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "FUZZ-2.0 Pro",
  "prompt": "A song for Christmas"
}'

自定义生成

如果想自定义生成歌词，可以输入歌词：

这时候 lyric 字段可以传入类似如下内容：

1

[Verse]Woke up with the sun in my eyesNo clouds above just blue in the skiesShoes on my feet I’m ready to runEvery step feels like a loaded gun[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Verse 2]Dancing through the city streetsA rhythm pounding in my heartbeatStrangers smile it’s catching onThis world’s a stage we’re all a song[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Bridge]Throw your worries out the doorLet them sink to the ocean floorWe’re alive and it’s enoughLife is messy but it’s love[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high

接下来我们要根据歌词、标题、风格自定义生成歌曲，就可以指定如下内容：

• lyric：歌词文本
• custom：填写为 true，代表自定义生成，该参数默认为 false，代表使用 prompt 生成。
• title：歌曲的标题。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "custom": true
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "success": true,
  "task_id": "9f58bbd4-855a-4233-ac45-b63bf9168e02",
  "trace_id": "145ad117-6ce7-42dd-af12-70751c5284fc",
  "data": [
    {
      "id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
      "title": "Woke up with the sun in my eyes",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/38d3b9e2-0dfb-4338-b2a7-15e45656ed32.jpg",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/38d3b9e2-0dfb-4338-b2a7-15e45656ed32.m4a",
      "video_url": null,
      "image_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
      "topic": null,
      "seed": "3789209121",
      "sound": "",
      "created_at": "2025-12-30T17:26:46.357055Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "153.80897959183673"
    }
  ]
}

翻唱歌曲

如果想对已经生成的歌曲进行翻唱操作的操作，可以输入上文生成的歌曲进行翻唱，接下来我们要根据歌词、标题自定义生成歌曲。

如果想对自己上传的歌曲进行继续翻唱的话，可以将参数 action 设置为 upload_cover ，并且输入需要继续翻唱自定义上传的歌曲 ID，歌曲 ID 的获取是使用 Producer Upload API来获取，如下图所示：

就可以指定如下内容：

• action：此次歌曲任务的行为，目前支持：generate、cover、extend、upload_cover、upload_extend、replace_section、swap_vocals、swap_instrumentals、variation，此次翻唱使用cover参数。
• lyric：歌词文本
• title：歌曲的标题。
• custom：是否采用自定义模式生成，默认是false。
• audio_id：需要翻唱歌曲的歌曲ID。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "cover",
  "model": "FUZZ-2.0 Pro",
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "instrumental": false,
  "custom": true,
  "title": "Cover"
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "success": true,
  "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f",
  "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa",
  "data": [
    {
      "id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "title": "Cover",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/e52dd729-38b4-4c2f-9031-59eb7953c593.jpg",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/e52dd729-38b4-4c2f-9031-59eb7953c593.m4a",
      "video_url": null,
      "image_id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "topic": null,
      "seed": "358803418",
      "sound": "",
      "created_at": "2025-12-30T17:32:32.951948Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "153.0659410430839"
    }
  ]
}

续写歌曲

如果想续写歌曲的话，我们需要传入action参数值为：extend，接下来我们要根据歌词、标题、风格自定义生成歌曲。

如果想对自己上传的歌曲进行继续续写的话，可以将参数 action 设置为 upload_extend ，并且输入需要继续续写自定义上传的歌曲 ID，歌曲 ID 的获取是使用 Producer Upload API来获取，如下图所示：

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "extend",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "continue_at": 3,
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "custom": true,
  "title": "Extend",
  "weirdness": 0.3,
  "sound_strength": 0.3,
  "lyrics_strength": 0.6
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "success": true,
  "task_id": "834983cb-d62d-4750-b1aa-461da137e51f",
  "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0",
  "data": [
    {
      "id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "title": "Extend",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/d9ebc609-fb65-4a23-b914-c074747af6a4.jpg",
      "lyric": "[Verse]\n[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/d9ebc609-fb65-4a23-b914-c074747af6a4.m4a",
      "video_url": null,
      "image_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "topic": null,
      "seed": "4294469624",
      "sound": "",
      "created_at": "2025-12-30T17:36:14.520928Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "173.87102040816328"
    }
  ]
}

音乐变换

如果想根据上一首音乐的seed值生成一首类似效果的新音乐的话，我们需要传入action参数值为：variation，接下来就可以自定义生成一首类似效果的新音乐。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "variation",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "custom": true
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "success": true,
    "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39",
    "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7",
    "data": [
        {
            "id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "title": "Woke up with the sun in my eyes",
            "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/c14ca458-cd5a-4700-83d4-5249e15f2707.jpg",
            "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
            "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/c14ca458-cd5a-4700-83d4-5249e15f2707.m4a",
            "video_url": null,
            "image_id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "topic": null,
            "seed": "2082104582",
            "sound": "",
            "created_at": "2025-12-30T17:48:40.135187Z",
            "model": "FUZZ-2.0",
            "progress": "100%",
            "state": "succeeded",
            "duration": "173.12798185941043"
        }
    ]
}

替换片段

如果想对歌曲进行替换片段的话，我们需要传入action参数值为：replace_section，接下来我们要根据歌词、标题自定义生成歌曲。

如果想对自己上传的歌曲进行继续替换片段的话，可以将参数 action 设置为 upload_replace_section ，并且输入需要继续续写自定义上传的歌曲 ID，歌曲 ID 的获取是使用 Producer Upload API来获取，如下图所示：

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "replace_section",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\\nWoke up with the sun in my eyes\\nNo clouds above just blue in the skies\\nShoes on my feet I’m ready to run\\nEvery step feels like a loaded gun\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Verse 2]\\nDancing through the city streets\\nA rhythm pounding in my heartbeat\\nStrangers smile it’s catching on\\nThis world’s a stage we’re all a song\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Bridge]\\nThrow your worries out the door\\nLet them sink to the ocean floor\\nWe’re alive and it’s enough\\nLife is messy but it’s love\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "replace_section_start": 3,
  "replace_section_end": 70,
  "custom": true
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "success": true,
    "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f",
    "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f",
    "data": [
        {
            "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "title": "Woke up with the sun in my eyes",
            "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/a54609c6-13e2-4176-be0f-4d7eebc68e1f.jpg",
            "lyric": "[Verse]\\nWoke up with the sun in my eyes\\nNo clouds above just blue in the skies\\nShoes on my feet I’m ready to run\\nEvery step feels like a loaded gun\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Verse 2]\\nDancing through the city streets\\nA rhythm pounding in my heartbeat\\nStrangers smile it’s catching on\\nThis world’s a stage we’re all a song\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high\\n[Bridge]\\nThrow your worries out the door\\nLet them sink to the ocean floor\\nWe’re alive and it’s enough\\nLife is messy but it’s love\\n[Chorus]\\nHappy days are rolling in\\nLet the joy beneath my skin\\nNo more shadows no more lies\\nJust the truth that lifts me high",
            "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/a54609c6-13e2-4176-be0f-4d7eebc68e1f.m4a",
            "video_url": null,
            "image_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "topic": null,
            "seed": "14887454",
            "sound": "",
            "created_at": "2025-12-30T18:01:19.907443Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "174.6140589569161"
        }
    ]
}

伴奏翻版

如果想使用官方的伴奏翻版操作，可以将action参数值设为：swap_instrumentals，接下来我们要根据歌词、标题自定义生成歌曲。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "swap_instrumentals",
  "model": "FUZZ-2.0 Pro",
  "weirdness": 0.6,
  "prompt": "Happy",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4"
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "success": true,
  "task_id": "d17d8376-3a58-451d-a976-404719bac11d",
  "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b",
  "data": [
    {
      "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "title": "Extend (Sound swap)",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b.jpg",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b.m4a",
      "video_url": null,
      "image_id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "topic": null,
      "seed": "2157878068",
      "sound": "Happy",
      "created_at": "2025-12-30T18:09:49.594800Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "172.3849433106576"
    }
  ]
}

人声翻版

如果想使用官方的人声翻版操作，可以将action参数值设为：swap_vocals，接下来我们要根据歌词、标题、风格自定义生成歌曲。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8
9
10
11
12
13
14

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "swap_vocals",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "weirdness": 0.6,
  "lyrics_strength": 0.8,
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "custom": true
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
  "success": true,
  "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32",
  "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1",
  "data": [
    {
      "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "title": "Woke up with the sun in my eyes",
      "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/image/7b2d653b-aaaa-41b0-b737-aee4c4c5693b.jpg",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/7ce2b11a-179f-4b87-b5ff-397613c62c93/audio/7b2d653b-aaaa-41b0-b737-aee4c4c5693b.m4a",
      "video_url": null,
      "image_id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "topic": null,
      "seed": "2484735707",
      "sound": "",
      "created_at": "2025-12-30T18:13:01.349875Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "173.12798185941043"
    }
  ]
}

词曲分离

如果想使用官方的词曲分离操作，可以将action参数值设为：stems，接下来我们要根据歌曲ID进行词曲分离。

填写样例如下：

填写完毕之后自动生成了代码如下：

对应的代码：

1
2
3
4
5
6
7
8

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "stems",
  "audio_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f"
}'

测试允许，生成的效果是类似的。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

{
    "success": true,
    "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc",
    "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217",
    "data": [
        {
            "title": "Woke up with the sun in my eyes",
            "lyric": "",
            "stems_url": "https://platform.cdn.acedata.cloud/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip",
            "model": "",
            "progress": "100%",
            "state": "succeeded"
        }
    ]
}

异步回调

由于 Producer Audios Generation API 生成的时间有时候会相对较长，如果 API 长时间无响应，HTTP 请求会一直保持连接，导致额外的系统资源消耗，所以本 API 也提供了异步回调的支持。

整体流程是：客户端发起请求的时候，额外指定一个 callback_url 字段，客户端发起 API 请求之后，API 会立马返回一个结果，包含一个 task_id 的字段信息，代表当前的任务 ID。当任务完成之后，生成任务的结果会通过 POST JSON 的形式发送到客户端指定的 callback_url，其中也包括了 task_id 字段，这样任务结果就可以通过 ID 关联起来了。

下面我们通过示例来了解下具体怎样操作。

首先，Webhook 回调是一个可以接收 HTTP 请求的服务，开发者应该替换为自己搭建的 HTTP 服务器的 URL。此处为了方便演示，使用一个公开的 Webhook 样例网站 https://webhook.site/，打开该网站即可得到一个 Webhook URL，如图所示：

将此 URL 复制下来，就可以作为 Webhook 来使用，此处的样例为 https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1。

接下来，我们可以设置字段 callback_url 为上述 Webhook URL，同时填入相应的参数，具体的内容如图所示：

点击运行，可以发现会立即得到一个结果，如下：

1
2
3

{
  "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad"
}

稍等片刻，我们可以在 https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1 上观察到生成任务的结果，如图所示：

内容如下：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

{
    "success": true,
    "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
    "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb",
    "data": [
        {
            "id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "title": "Woke up with the sun in my eyes",
            "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/image/1dd08826-478e-43a6-868f-aff5ababac2c.jpg",
            "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
            "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/audio/1dd08826-478e-43a6-868f-aff5ababac2c.m4a",
            "video_url": null,
            "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "topic": null,
            "seed": "1490770667",
            "sound": "",
            "created_at": "2025-12-30T18:36:00.994141Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "135.2330158730159"
        }
    ]
}

可以看到结果中有一个 task_id 字段，其他的字段都和上文类似，通过该字段即可实现任务的关联。

错误处理

在调用 API 时，如果遇到错误，API 会返回相应的错误代码和信息。例如：

• 400 token_mismatched：Bad request, possibly due to missing or invalid parameters.
• 400 api_not_implemented：Bad request, possibly due to missing or invalid parameters.
• 401 invalid_token：Unauthorized, invalid or missing authorization token.
• 429 too_many_requests：Too many requests, you have exceeded the rate limit.
• 500 api_error：Internal server error, something went wrong on the server.

错误响应示例

1
2
3
4
5
6
7
8

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

结论

通过本文档，您已经了解了如何使用 Producer Audios Generation API 可通过输入提示词来生成音乐。希望本文档能帮助您更好地对接和使用该 API。如有任何问题，请随时联系我们的技术支持团队。

本文将介绍一种 SeeDance Videos Generation API 对接说明，它是可以通过输入自定义参数来生成SeeDance官方的视频。

申请流程

要使用 API，需要先到 SeeDance Videos Generation API 对应页面申请对应的服务，进入页面之后，点击「Acquire」按钮，如图所示：

如果你尚未登录或注册，会自动跳转到登录页面邀请您来注册和登录，登录注册之后会自动返回当前页面。

在首次申请时会有免费额度赠送，可以免费使用该 API。

基本使用

首先先了解下基本的使用方式，就是输入提示词 content.text、类型content.type=text 以及模型 model，便可获得处理后的结果，具体的内容如下：

可以看到这里我们设置了 Request Headers，包括：

• accept：想要接收怎样格式的响应结果，这里填写为 application/json，即 JSON 格式。
• authorization：调用 API 的密钥，申请之后可以直接下拉选择。

另外设置了 Request Body，包括：

• model：生成视频的模型，主要有doubao-seedance-1-0-pro-250528、doubao-seedance-1-0-pro-fast-251015,doubao-seedance-1-5-pro-251215,doubao-seedance-1-0-lite-t2v-250428,doubao-seedance-1-0-lite-i2v-250428
• context：content的type可以是text，也可以是image_url, image_url支持图片链接和base64数组两种，image_url和text参数互斥。
• service_tier：有default和flex两种。
• return_last_frame：是否返回最后一帧
• execution_expires_after：执行超时时间。
• callback_url：需要回调结果的URL。

选择之后，可以发现右侧也生成了对应代码，如图所示：

点击「Try」按钮即可进行测试，如上图所示，这里我们就得到了如下结果：

1
2
3
4
5
6
7
8
9
10
11

{
  "success": true,
  "task_id": "ec22ae22-0140-4033-8c86-a48b536da595",
  "trace_id": "1cc87db0-8ee5-4436-969b-35cc571a9fd5",
  "data": {
    "task_id": "cgt-20251222005129-62fhb",
    "status": "succeeded",
    "video_url": "https://platform.cdn.acedata.cloud/seedance/f592800a-b87c-4705-8796-cbb8018cae35.mp4",
    "model": "doubao-seedance-1-0-pro-250528"
  }
}

返回结果一共有多个字段，介绍如下：

• success，此时视频生成任务的状态情况。
• task_id，此时视频生成任务ID。
• trace_id，此时视频生成跟踪ID。
• data，此时视频生成任务的结果列表。
  • task_id，此时视频生成任务的服务器端ID。
  • video_url，此时视频生成任务的视频链接。
  • status，此时视频生成任务的状态。
  • model，生成视频使用的模型。