97AI.PRO API 入門(重要)
97AI.PRO へようこそ。本ガイドでは、97AI.PRO の API を製品に統合するために必要な基本情報(モデル、料金、認証、リクエストの流れ、制限、サポート)を順に説明します。
私たちは透明で、実用的で、開発者にやさしくあることを目指しています。本番投入の前に、よくお読みください。
1. 利用可能なモデルと Playground
最新の対応モデルはマーケットページで確認できます:👉 /market
新しいモデルは安定次第、継続的に更新・追加しています。
各モデルページには Playground へのリンクがあり、API を呼び出す前に UI 上で直接テスト・実験できます。Playground はモデルの挙動、パラメータ、出力形式を理解するのに最適な場所です。
2. 料金
完全かつ最新の料金一覧はこちら:👉 /pricing
当社の価格は通常、公式 API より 30〜50% 低く、一部のモデルでは割引が最大 80% に達します。
上流プロバイダーがコストを調整すると価格も変わる場合があるため、最新の数値は必ず料金ページをご確認ください。
3. API キーの作成と保護
API キーの作成・管理はこちら:👉 /api-keys
重要なセキュリティ上の注意:
- API キーをフロントエンドのコード(ブラウザ、モバイルアプリ、公開リポジトリ)に絶対に露出しないでください。
- API キーは機密情報として扱ってください。
利用の保護のため、次を提供しています:
- キーごとのレート制限(時間・日次・累計の上限)
- IP ホワイトリスト対応(承認済みのサーバー IP のみ API アクセスを許可)
4. 必須のリクエストヘッダー
すべての API リクエストには正しいヘッダーが必要です:
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/jsonこれらのヘッダーが欠落または誤っている場合、次が返ることがあります:
{"error":"Please log in or provide an API key"}5. ログとタスク詳細
過去のすべてのタスクはこちらで確認できます:👉 /logs
各タスクでは、作成時刻、使用モデル、入力パラメータ、タスク状態、クレジット消費、最終結果またはエラー詳細を確認できます。
6. データ保持ポリシー
- 生成されたメディアファイル:14 日間保存後、自動的に削除
- ログ記録(テキスト / メタデータ):2 か月間保存後、自動的に削除
長期的なアクセスが必要な場合は、結果を早めにご自身の側でダウンロード・保存してください。
7. 非同期タスクモデル
97AI.PRO のすべての生成タスクは非同期です。成功した POST /api/generate は HTTP 200 と taskId、state: "waiting" を返します。
これはタスクが受理されたことを意味するだけで、完了ではありません。state が success または fail になるまで、数秒ごとに GET /api/generate/{taskId} をポーリングしてください。チャットリクエスト(POST /api/chat)は同期処理で、応答を直接返します。
8. 制限と公正な利用
- 現在、リレーに厳密なレートや同時実行の制限はありません。
- タスクを開始するには最低残高(デフォルト 50 クレジット)が必要で、完了時に実費で精算されます。
- 失敗したタスクは課金されません。
それでも責任を持って呼び出してください — 濫用的なトラフィックは制限される場合があります。高スループットの保証が必要な場合はコミュニティ経由でご連絡ください。
9. 開発者サポート
コミュニティ で質問やフィードバックを共有してください — 私たちや他の開発者に最も速く連絡できる方法です。
[email protected] へのメールも可能です。生成失敗を報告する際は taskId を添えてください。
10. 安定性についての想定
私たちは、非常に積極的な価格で最高水準かつ競争力のある API へのアクセスを提供します。全体的な安定性は公式プロバイダーよりわずかに低い場合があります — これは意図的なトレードオフです。実際には、97AI.PRO は本番ワークロードと長期的な事業成長を支えるのに十分安定しています。
11. チームについて
97AI.PRO は小さなスタートアップチームによって作られています。私たちは素早く動き、開発者体験を深く大切にし、常に改善しています。皆さまのフィードバックが改善に役立ちます — 心から感謝します。