共通 API クイックスタート

アカウント管理と生成コンテンツ向けの基本ユーティリティ API。

共通 API へようこそ

共通 API は、97AI.PRO アカウントの管理と生成コンテンツの取り扱いのための基本的なユーティリティサービスを提供します。これらの API により、クレジット使用状況の監視と生成ファイルへの効率的なアクセスが可能になります。

アカウントのクレジットを確認

現在のクレジット残高を確認し、使用状況を監視

生成ファイルをダウンロード

タスクの結果 URL から結果ファイルを直接取得

認証

すべての API リクエストは Bearer トークンによる認証が必要です。API キー管理ページで API キーを取得し、安全に保管してください。

API ベース URL

https://97ai.97claude.com

Authorization ヘッダー

Authorization: Bearer YOUR_API_KEY

クイックスタートガイド

2 つの基本操作：クレジット残高を確認し、完了したタスクの結果ファイルをダウンロードします。

ステップ 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 未認証（キーの欠落/無効）、402 クレジット不足、403 禁止（キーがそのモデルで許可されていない）、404 未検出（不明な taskId）、500 サーバーエラー。

重要な注意事項

ファイル保持

生成メディアは 14 日間保持されます — すぐにダウンロードし、重要な結果はご自身の側で保存してください。

クレジット残高

クレジットが尽きるとサービスへのアクセスが制限されます。残高を監視し、低残高アラートを設定し、チャージを前もって計画してください。

サポート

メール：[email protected] · ドキュメント：https://97ai.97claude.com/docs · API ステータス：各モデルページでリアルタイムの稼働状況を確認できます。