01-产品概述与快速入门

前提条件

• 已完成阿里云企业实名认证（个人账号无法开通）。

操作步骤

1. 访问阿里云云市场的悠船 AI 绘图大模型店铺，点击立即购买。

2. 勾选同意《服务商用户协议》与《云市场平台服务协议》，点击立即开通。

3. 开通后，进入云市场买家控制台 > 我的服务 > 详情，获取以下凭证：

   • 机构号（x-youchuan-app）：平台机构标识，用于识别调用方身份。

   • 授权码（x-youchuan-secret）：机构授权凭证，用于身份验证。

注意

机构号与授权码是 API 调用的唯一身份验证凭证，请妥善保管，切勿泄露至客户端代码或公共代码仓库中。

第一步：获取凭证

在云市场买家控制台获取 x-youchuan-app 和 x-youchuan-secret，具体步骤参见上文「开通服务」章节。

第二步：发起图像生成请求

import requests

url = "https://ali.youchuan.cn/v1/tob/diffusion"
headers = {
    "Content-Type": "application/json",
    "x-youchuan-app": "YOUR_APP_ID",
    "x-youchuan-secret": "YOUR_SECRET_KEY"
}
data = {
    "text": "A beautiful sunset over the mountains",
    "callback": "https://your-server.com/callback"  # 可选：异步回调地址
}

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

第三步：获取生成结果

任务提交成功后，有两种方式获取结果：

方式一：回调通知（推荐）

在请求中传入 callback 参数，任务完成后系统会将结果推送至您指定的回调地址。回调通知的 JSON 结构示例：

{
  "jobId": "abc123",
  "status": "JobStatusSuccess",
  "urls": ["https://cdn.example.com/image1.png"],
  "cost": 1.0
}

方式二：主动查询

通过任务查询接口轮询任务状态：

import requests

job_id = "abc123"
url = f"https://ali.youchuan.cn/v1/tob/job/{job_id}"
headers = {
    "x-youchuan-app": "YOUR_APP_ID",
    "x-youchuan-secret": "YOUR_SECRET_KEY"
}

response = requests.get(url, headers=headers)
result = response.json()
print(result)

说明

• 当前不支持图片生成进度的实时通知，建议优先使用回调方式。

• 所有生成的图像将保留 30 天，请及时下载保存。

• 内容审核：根据中国网络安全相关法律法规，所有生成内容会经过合规审核，包含违规内容的提示词可能会被拒绝。

基础单价

标准任务单价：0.6 元/次。

任务系数

速度系数

示例： 使用快速模式生成一张 480p 视频（--bs 1）的费用为：0.6 × 4.0 × 1.0 × 0.25 = 0.6 元。