開発ガイド
このガイドでは、APIサービスをアプリケーションに統合する方法を説明します。非同期処理
APIは非同期処理モデルを使用しています:- タスクを送信:生成リクエストを送信してタスクIDを受け取る
- ステータスをポーリング:定期的にタスクのステータスを確認する
- 結果を取得:タスクが完了したら生成結果を取得する
ポーリングの例
エラー処理
よくあるエラー
| ステータス | 説明 | 解決方法 |
|---|---|---|
| 400 | 無効なリクエストパラメータ | リクエストパラメータとフォーマットを確認する |
| 401 | 認証失敗 | APIキーを確認する |
| 402 | 残高不足 | アカウント残高をチャージする |
| 429 | レート制限超過 | リクエストの頻度を減らす |
| 500 | サーバーエラー | 後で再試行する |
例
ベストプラクティス
- キャッシング:生成された画像/動画のリンクは24時間有効です
- リトライ:一時的なエラーには指数バックオフを実装する
- モニタリング:API使用状況とクォータを定期的に確認する
- セキュリティ:APIキーを安全に保管する
サポート
開発中に問題が発生した場合は、以下の方法でサポートを受けられます:- メール:zhihong@apimart.ai
- ライブチャット:ウェブサイトにアクセス
- ドキュメント:完全なAPIドキュメントを参照