图文生成openAPI

版本变更

概述

本产品中的基本概念如下：

接入认证

接入准备

1. 需要接入方提前准备阿里云账号，并利用阿里云子账号生成对应的AK/SK；

2. 阿里云主账号需要对生成AK/SK的子账号进行RAM授权；

3. 使用阿里云主账号登录平台，签署相关法务协议。

产品规格

API概览

本产品中所有开放的API，按照功能目录分类，将API链接和API描述罗列出来。

通用接口

文案接口

配图接口

API详情

GetOssUploadToken

接口说明：获取oss上传签名

入参：GetOssUploadRequest

出参：UploadInfo

CreateTextTask

接口说明：创建文案任务

入参：TextTaskCreateCmd

ReferenceTag:

出参：TextTaskResult

TextTask：

ReferenceTag:

生成模式-微信朋友圈调用模板

{
    "number": 2,
    "textModeType": "Generate",
    "style": "WECHAT_MOMENT",
    "industry": "CulturalTour", 
    "introduction": "九寨沟山清水秀，环境优美。" ,
    "themes": [
      "TOUR_ROUTE",
      "ATTRACTION_TICKET"
    ]
}

生成模式-小红书调用模板

{
    "number": 2,
    "textModeType": "Generate",
    "style": "RED_BOOK",
    "industry": "CulturalTour",
    "contentRequirement": "厦门4日游",
    "introduction": "路线安排 第1天: 中山路-猫街-沙坡尾-黄厝沙滩（日出）-曾厝按 第2天: 厦门植物园-厦门大学（需预约）-南普陀寺-钟鼓索道-演武大桥(观日落) 第3天: 鼓浪屿-八市 第4天: 海上地铁-海堤路-集美学村-厦门北",
    "point": "景点旅游线路",
    "target": "Seller",
    "themes": [
      "TOUR_ROUTE"
    ]
}

GetTextTask

接口说明：获取文案任务

入参：

出参：TextTaskResult

TextTask：

GetText

接口说明：查看文案内容

入参：

出参：TextResult

Text：

ListTexts

接口说明：列举文案

入参：

出参：

ListTextThemes

接口说明：查询文案主题列表

入参：

出参：TextThemeListResult

TextTheme：

CreateIllustrationTask

接口说明：创建配图任务

入参：

IllustrationTaskCreateCmd：

出参：IllustrationTaskResult

IllustrationTask：

GetIllustrationTask

接口说明：查询配图任务

入参：

出参：IllustrationTaskResult

GetIllustration

接口说明：查询配图

入参：

出参：IllustrationResult

illustration：

GetTextTemplate

接口说明：查询文本模板

入参：

出参：TextTemplateOpenResult

AvailableIndustryOpen：

AvailableTextModeTypeOpen：

AvailableTextStyleOpen：

{
        "requestId": "0987EED3-752A-150A-B78B-ABCDD4890507",
        "availableIndustry": {
            "textModeTypes": [
                {
                    "name": "Generate",
                    "textStyles": [
                        {
                            "name": "RED_BOOK",
                            "disabled": false,
                            "desc": "小红书"
                        },
                        {
                            "name": "WECHAT_MOMENT",
                            "disabled": false,
                            "desc": "朋友圈"
                        }
                    ]
                },
                {
                    "name": "Rewrite",
                    "textStyles": [
                        {
                            "name": "RED_BOOK",
                            "disabled": false,
                            "desc": "小红书"
                        },
                        {
                            "name": "WECHAT_MOMENT",
                            "disabled": false,
                            "desc": "朋友圈"
                        }
                    ]
                }
            ],
            "name": "Common"
        }
    }

AddTextFeedback

接口说明：添加文案效果反馈

入参：

出参

CountText

接口说明：统计文案数量

入参：

出参

附录

行业信息枚举

Car: 汽车行业
Common: 通用行业
CulturalTour: 文旅行业
Garment: 运动户外行业
Internet: 互联网工具行业

RED_BOOK ： 小红书
WECHAT_MOMENT ：朋友圈
TIKTOK ：抖音
ZHIHU ：知乎
QIWEI_TEXT ：企微话术
VIDEO_SCRIPT ：视频脚本

SDK下载及更新

PHP

接入参考

require 'vendor/autoload.php';
use AlibabaCloud\SDK\Imarketing\V20220704\Models\GetOssUploadSignatureRequest;
use AlibabaCloud\SDK\IntelligentCreation\V20240313\IntelligentCreation;
use Darabonba\OpenApi\Models\Config as AlibabaConfig;

$config = new AlibabaConfig();
$config->accessKeyId = '****';
$config->accessKeySecret = '****';
$config->endpoint = "intelligentcreation.cn-zhangjiakou.aliyuncs.com";

$intelligentCreationClient = new IntelligentCreation($config);

// GetOssUploadToken 接口示例
$request = new GetOssUploadSignatureRequest();
$request->fileName = 'xxx.png';
$request->fileType = "ProductImage";
try {
    $response = $intelligentCreationClient->getOssUploadToken($request);
    var_dump($response->toMap());
} catch (TeaError $e) {
    Log::error($e);
}

2.2.0

u-a4bf8c7a-c6fd-42d3-94af-d52e9f095a56-composer-tea.zip

composer require alibabacloud/intelligentcreation-20240313 2.2.0

2.1.4

u-ce29b5c7-8a37-4590-98f4-71a02e5366f9-composer-tea.zip

composer require -W alibabacloud/intelligentcreation-20240313 2.1.4

2.0.2

u-cf800400-f94e-495b-ac5f-404e4fbc2f5a-composer-tea.zip

composer require alibabacloud/intelligentcreation-20240313 2.0.2

2.0.0

u-b27117b1-7af9-4255-a725-1cd2b688a921-composer-tea.zip

composer require alibabacloud/intelligentcreation-20240313 2.0.0

1.0.0

u-7e0b8929-6999-4650-bf07-6d757195633b-composer-tea.zip

composer require alibabacloud/intelligentcreation-20240313 1.0.0

Java

接入参考

package com.aliyun;

import com.aliyun.intelligentcreation20240313.Client;
import com.aliyun.intelligentcreation20240313.models.GetOssUploadTokenRequest;
import com.aliyun.intelligentcreation20240313.models.GetOssUploadTokenResponse;
import com.aliyun.intelligentcreation20240313.models.UploadInfo;
import com.aliyun.teaopenapi.models.Config;

import java.util.HashMap;
import java.util.Map;

public class Test {

    public static void main(String[] args) throws Exception {
  //初始化配置
        Config config = new Config().setAccessKeyId("test").setAccessKeySecret("test").setEndpoint("intelligentcreation.cn-zhangjiakou.aliyuncs.com");
// 创建客户端
        Client client = new Client(config);

        Map<String, Object> map = new HashMap<>();
        map.put("fileName","xxx.png");
        map.put("fileType","ProductImage");
        GetOssUploadTokenRequest request = GetOssUploadTokenRequest.build(map);
// 请求接口
        GetOssUploadTokenResponse response = client.getOssUploadToken(request);
        if (response.getStatusCode().equals(200)) {
            System.out.println("请求成功");
            UploadInfo uploadInfo = response.getBody().getUploadInfo();
            System.out.println("请求出参：" + uploadInfo);
        }

    }
}

2.2.0

u-a4bf8c7a-c6fd-42d3-94af-d52e9f095a56-java-tea.zip

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>intelligentcreation20240313</artifactId>
  <version>2.2.0</version>
</dependency>

2.1.0

u-ce29b5c7-8a37-4590-98f4-71a02e5366f9-java-tea.zip

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>intelligentcreation20240313</artifactId>
  <version>2.1.0</version>
</dependency>

2.0.2

u-cf800400-f94e-495b-ac5f-404e4fbc2f5a-java-tea.zip

<dependency>
  <groupId>com.aliyun</groupId>
  <artifactId>intelligentcreation20240313</artifactId>
  <version>2.0.2</version>
</dependency>

GO

接入参考

import (
	"fmt"
	"strings"

	facebody "github.com/alibabacloud-go/facebody-20191230/client"
	rpc "github.com/alibabacloud-go/tea-rpc/client"
	util "github.com/alibabacloud-go/tea-utils/service"
	credential "github.com/aliyun/credentials-go/credentials"
)

func main() {
	config := new(rpc.Config)

	// 使用 ak 初始化 config
	config.SetAccessKeyId("ACCESS_KEY_ID").
		SetAccessKeySecret("ACCESS_KEY_SECRET").
		SetRegionId("cn-zhangjiakou").
		SetEndpoint("intelligentcreation.cn-zhangjiakou.aliyuncs.com")

	// 使用 credential 初始化 config
	credentialConfig := &credential.Config{
		AccessKeyId:     config.AccessKeyId,
		AccessKeySecret: config.AccessKeySecret,
		SecurityToken:   config.SecurityToken,
	}
	// 关于 credenial 的创建可以参考 https://github.com/aliyun/credentials-go/blob/master/README-CN.md
	cred, err := credential.NewCredential(credentialConfig)
	if err != nil {
		panic(err)
	}
	config.SetCredential(cred).
		SetEndpoint("intelligentcreation.cn-zhangjiakou.aliyuncs.com")

	// 创建客户端
	client, err := facebody.NewClient(config)
	if err != nil {
		panic(err)
	}

	// 初始化 runtimeObject
	runtimeObject := new(util.RuntimeOptions).SetAutoretry(false).
		SetMaxIdleConns(3)

	// 初始化 request
	request := new(facebody.DetectFaceRequest)

	// 调用 api
	resp, err := client.DetectFace(request, runtimeObject)
	if err != nil {
		fmt.Println(err.Error())
	}
	fmt.Println(resp)

}

SDK

go get github.com/alibabacloud-go/intelligentcreation-20240313/v2