通用 API 快速开始

用于账户管理与生成内容的基础工具 API。

欢迎使用通用 API

通用 API 提供管理你的 97AI.PRO 账户与处理生成内容的基础工具服务。这些 API 帮助你监控积分使用、并高效获取生成的文件。

查询账户积分

查看当前积分余额并监控用量

下载生成的文件

直接从任务结果 URL 获取结果文件

认证

所有 API 请求都需使用 Bearer token 认证。请在「API Key 管理」页获取你的 API Key，并妥善保管。

API 基础 URL

https://97ai.97claude.com

认证请求头

Authorization: Bearer YOUR_API_KEY

快速开始指南

两个基本操作：先查询积分余额，再下载已完成任务的结果文件。

步骤 1：查询积分余额

cURL

curl -X GET "https://97ai.97claude.com/api/credits" \
  -H "Authorization: Bearer YOUR_API_KEY"

响应示例

JSON

{
  "credits": 1950
}

步骤 2：下载生成的文件

任务完成后，GET /api/generate/{taskId} 会返回 resultUrls —— 生成媒体的可直接下载 URL：

cURL

curl -X GET "https://97ai.97claude.com/api/generate/task_12345678" \
  -H "Authorization: Bearer YOUR_API_KEY"
# → { "state": "success", "resultUrls": ["https://…/out.jpg"], … }

curl -o out.jpg "https://…/out.jpg"

媒体文件保留 14 天。

请及时下载并在你自己一侧保存重要结果。

API 概览

查询账户积分 —— GET /api/credits

获取实时积分余额
无需参数，立即响应
用量监控与低积分告警的必备接口

任务结果 —— GET /api/generate/{taskId}

resultUrls 覆盖所有生成文件类型（图像、视频、音频等）
URL 可直接下载 —— 无需额外换取步骤
文件保留 14 天后自动删除

实用示例

一个自动化积分监控客户端：

JavaScript

class Ai97Client {
  constructor(apiKey) {
    this.apiKey = apiKey;
    this.baseUrl = 'https://97ai.97claude.com';
  }
  async getCredits() {
    const res = await fetch(this.baseUrl + '/api/credits', {
      headers: { 'Authorization': 'Bearer ' + this.apiKey }
    });
    if (!res.ok) throw new Error('Failed to get credits: ' + res.statusText);
    return (await res.json()).credits;
  }
  async getResultUrls(taskId) {
    const res = await fetch(this.baseUrl + '/api/generate/' + taskId, {
      headers: { 'Authorization': 'Bearer ' + this.apiKey }
    });
    const j = await res.json();
    return j.state === 'success' ? j.resultUrls : null;
  }
  async checkCreditsAndWarn(threshold = 10) {
    const credits = await this.getCredits();
    if (credits < threshold) { console.warn('Low credits: ' + credits); return false; }
    return true;
  }
}

错误处理

常见错误：401 未授权（缺失/无效 Key）、402 积分不足、403 禁止访问（Key 未授权该模型）、404 未找到（未知 taskId）、500 服务器错误。

重要说明

文件保留

生成媒体保留 14 天 —— 请立即下载并在你自己一侧保存重要结果。

积分余额

积分耗尽时服务访问将受限。请监控余额、设置低积分提醒并提前规划充值。

支持

邮箱：[email protected] · 文档：https://97ai.97claude.com/docs · API 状态：在各模型页查看实时健康状况。