快速开始

欢迎使用悠船API！本指南将帮助您快速开始使用我们的图像生成API。

获取API密钥

首先，您需要通过云市场开通悠船产品，并获取您的API密钥。

• x-youchuan-app：机构标识

• x-youchuan-secret：机构授权码

创建第一个请求

使用以下代码示例生成您的第一张图像：

import requests

url = "https://ali.youchuan.cn/v1/tob/diffusion"
headers = {
    "x-youchuan-app": "YOUR_APP_ID",
    "x-youchuan-secret": "YOUR_SECRET_KEY"
}
data = {
    "text": "A beautiful sunset over the mountains",
    "callback": ""
}

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

# 任务结果json示例
{
    "id": "68be9b50553a97d658968285",
    "text": "A beautiful sunset over the mountains",
    "urls": [],
    "status": 1,
    "comment": "执行中",
    "cost": {
        "jobId": "68be9b50553a97d658968285",
        "fastCost": 1,
        "relaxCost": 0,
        "feeCost": 50,
        "costAt": "2025-09-08T09:01:04.510389204Z"
    },
    "audits": [],
    "seed": 0
}

处理回调

当图像生成完成后，我们会向您指定的回调URL发送通知：

@app.route('/callback', methods=['POST'])
def handle_callback():
    data = request.json
    # 处理生成的图像
    image_url = data['urls']
    # ... 其他处理逻辑
    return 'OK'

# 通知结果示例
# 任务结果json示例
{
    "id": "68be9b50553a97d658968285",
    "text": "A beautiful sunset over the mountains",
    "urls": [
        "https://openapi-youchuan.oss-cn-shanghai.aliyuncs.com/xxxxx_1.png",
        "https://openapi-youchuan.oss-cn-shanghai.aliyuncs.com/xxxxx_2.png",
        "",
        "https://openapi-youchuan.oss-cn-shanghai.aliyuncs.com/xxxxx_4.png",
    ],
    "status": 2,
    "comment": "成功",
    "cost": {
        "jobId": "68be9b50553a97d658968285",
        "fastCost": 1,
        "relaxCost": 0,
        "feeCost": 50,
        "costAt": "2025-09-08T09:01:04.510743Z"
    },
    "audits": [
        "",
        "",
        "涉政",
        ""
    ],
    "seed": 4291795396
}

提示： 您也可以通过 任务查询接口 获取任务状态和结果

探索更多功能

• 图像编辑：使用编辑方法对生成的图像进行修改

• 高清处理：通过高清方法获得更高分辨率的图像

• 参数调整：尝试不同的参数组合以获得最佳效果