功能简介

CloudImageGenerate 是聚合图片生成服务，基于阿里云百炼大模型，提供文生图、图生图、图像编辑等多种 AI 图像能力。只需输入一段描述性的提示词（prompt），即可生成与描述相匹配的高质量图片。

适用场景

• 创意设计：快速将创意想法可视化为图片
• 内容创作：为文章、社交媒体生成配图
• 广告设计：快速生成广告素材的多个方案
• 产品设计：辅助产品概念设计和原型展示
• 图像编辑：基于已有图片进行智能修改和重绘

功能特性

• 多种模型：内置万相、Qwen-Image 等多个图像生成模型
• 文生图：根据文字描述生成全新图片
• 图生图：基于参考图进行风格迁移和二次创作
• 参数配置：支持尺寸、随机种子等参数自定义
• 异步处理：提交任务后轮询获取生成结果
• 点数计费：按模型配置动态计费（点/张）

资费标准

• 文生图 / 图生图：按模型实际价格计费，单位为「点/张」

1. 接口基础

使用前请阅读 接口基础 。

2. 任务提交（异步）

请求地址

[POST] https://api.tecmz.com/open_api/cloud_image_generate/queue

请求参数

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 任务ID
        "taskId": "1"
    }
}

3. 任务查询

请求地址

[POST] https://api.tecmz.com/open_api/cloud_image_generate/query

请求参数

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 任务状态：QUEUE | PROCESS | SUCCESS | FAIL
        "status": "SUCCESS",
        "result": {
            // 生成的图片URL
            "imageUrl": "https://example.com/generated-image.jpg"
        }
    }
}

4. 可用性检查

请求地址

[POST] https://api.tecmz.com/open_api/cloud_image_generate/available

返回

{
    "code": 0,
    "msg": "ok",
    "data": {
        // 当前可用服务器数量
        "availableCount": 1
    }
}

5. 示例代码

PHP

<?php
// 提交任务
$data = [
    'model' => 'wanx-v1',
    'prompt' => '一只可爱的小猫在花园里玩耍',
    'param' => [
        'size' => '1024*1024'
    ]
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://your-domain.com/open_api/cloud_image_generate/queue');
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Authorization: Bearer YOUR_API_TOKEN'
]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response, true);

if ($result['code'] == 0) {
    $taskId = $result['data']['taskId'];

    // 查询结果
    while (true) {
        $queryData = ['taskId' => $taskId];
        curl_setopt($ch, CURLOPT_URL, 'https://your-domain.com/open_api/cloud_image_generate/query');
        curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($queryData));

        $queryResponse = curl_exec($ch);
        $queryResult = json_decode($queryResponse, true);

        if ($queryResult['data']['status'] == 'SUCCESS') {
            $imageUrl = $queryResult['data']['result']['imageUrl'];
            echo "生成成功，图片地址：$imageUrl\n";
            break;
        } elseif ($queryResult['data']['status'] == 'FAIL') {
            echo "生成失败\n";
            break;
        }

        sleep(5); // 等待5秒后重试
    }
}

curl_close($ch);