acedatacloud-api

AceDataCloud API 使用指南

使用 AceDataCloud AI 驱动的数据服务 API 的完整指南。

开始使用

1. 创建账户

在 platform.acedata.cloud 注册。

2. 订阅服务

浏览可用服务，并点击 Get 进行订阅。大多数服务都包含免费额度。

3. 创建 API 凭据

前往服务的 Credentials 页面，创建 API Token。

完整详情： 有关 Token 类型和用法，请参阅身份验证。

SDK 集成（兼容 OpenAI）

对于聊天补全服务，请使用标准的 OpenAI SDK：

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_TOKEN",
    base_url="https://api.acedata.cloud/v1"
)

response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello!"}]
)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "YOUR_API_TOKEN",
  baseURL: "https://api.acedata.cloud/v1"
});

const response = await client.chat.completions.create({
  model: "gpt-4.1",
  messages: [{ role: "user", content: "Hello!" }]
});

请求模式

同步 API

部分 API 会立即返回结果（例如，人脸变换、搜索）：

curl -X POST https://api.acedata.cloud/face/analyze \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"image_url": "https://example.com/photo.jpg"}'

异步任务 API

大多数生成类 API（图像、视频、音乐）都是异步的。

完整详情： 有关提交并轮询的模式，请参阅异步任务轮询。

错误处理

HTTP Code	含义	操作
400	请求无效	检查请求参数
401	未授权	检查 API Token
403	禁止访问	内容被过滤或权限不足
429	请求过多	等待后再重试，并使用退避策略
500	服务端错误	重试或联系支持团队

错误响应格式：

{
  "error": {
    "code": "token_mismatched",
    "message": "Invalid or expired token"
  }
}

计费

• 每次 API 调用都会从你的订阅余额（remaining_amount）中扣除费用
• 费用因服务、模型和用量（Token、请求次数、数据大小）而异
• 在 platform.acedata.cloud 查看余额
• 大多数服务都提供免费试用额度

服务类别

类别	服务	基础路径
AI 聊天	GPT、Claude、Gemini、Kimi、Grok	/v1/chat/completions
图像生成	Flux、Seedream、NanoBanana	/flux/*、/seedream/* 等
视频生成	Luma、Sora、Veo、Kling、Hailuo、Seedance、Wan	/luma/*、/sora/* 等
音乐生成	Suno、Producer、Fish Audio	/suno/*、/producer/*、/fish/*
搜索	Google Search（网页／图像／新闻／地图）	/serp/*
人脸	分析、美化、替换、卡通化、年龄变换	/face/*
实用工具	短链接、二维码艺术、头像照	/short-url、/qrart/*、/headshots/*

注意事项

• 默认情况下，Token 仅限于单项服务；如需跨服务访问，请创建全局 Token
• 异步 API 会返回 task_id；请始终使用 callback_url 立即获取 task_id，然后轮询结果
• 避免使用 wait: true；它会等待整个生成过程完成，视频／音乐任务可能因此超时
• 速率限制因服务等级而异；如果触及限制，请升级套餐
• 所有时间戳均采用 UTC

MCP： 有关与 AI Agent 集成工具调用的信息，请参阅 MCP 服务。