ドキュメント

写真復元API

AI技術を使用して古い写真を復元

写真復元APIを使用すると、高度なAI技術で古い、損傷した写真を復元できます。このエンドポイントは画像を処理し、復元されたバージョンを返します。Restore Old Photosの強力なAI写真復元機能をお試しください。

エンドポイント

POST /api/api-call/photo-restore

認証

Authorizationヘッダーに有効なAPIキーが必要です:

Authorization: Bearer YOUR_API_KEY

リクエスト

ヘッダー

ヘッダー必須説明
Content-Typeはいapplication/jsonである必要があります
AuthorizationはいBearer YOUR_API_KEY形式のAPIキー

ボディパラメータ

パラメータ必須説明
imageUrlstringはい復元する画像のURL(公開アクセス可能である必要があります)

リクエスト例

{
  "imageUrl": "https://example.com/old-photo.jpg"
}

レスポンス

成功レスポンス (200)

APIは復元された画像のURLまたはbase64文字列を返します。プラットフォームはすべてのストリームタイプを自動的に処理し、outputフィールドは常にURLまたはbase64文字列です。

{
  "output": "https://replicate.delivery/pbxt/xxx.png"
}

または:

{
  "output": "data:image/png;base64,iVBORw0KGgoAAAANS..."
}

説明

  • 出力は画像のURL(推奨)またはbase64文字列(部分画像/大きなファイル用)
  • ストリームオブジェクトは返されません。ユーザーはimgタグやダウンロードに直接使用できます

エラーレスポンス

400 Bad Request

{
  "message": "無効な入力"
}

401 Unauthorized

{
  "message": "無効または期限切れのAPIキー"
}

402 Payment Required

{
  "message": "クレジット不足"
}

500 Internal Server Error

{
  "message": "サービスエラー"
}

429 Too Many Requests

{
  "message": "レート制限を超えました。後でもう一度お試しください。"
}

レート制限

  • 制限: APIキーごとに1時間あたり100リクエスト
  • ウィンドウ: 60分
  • レスポンス: 超過時に429 Too Many Requests

使用例

JavaScript/Node.js

async function restorePhoto(imageUrl, apiKey) {
  try {
    const response = await fetch('https://restoreoldphotos.online/api/api-call/photo-restore', {
      method: 'POST',
      headers: {
        'Content-Type': 'application/json',
        'Authorization': `Bearer ${apiKey}`
      },
      body: JSON.stringify({
        imageUrl: imageUrl
      })
    });
 
    if (!response.ok) {
      const error = await response.text();
      throw new Error(`APIエラー: ${response.status} - ${error}`);
    }
 
    const result = await response.json();
    
    // 出力は常に文字列(URLまたはbase64)
    if (result.output.startsWith('data:image')) {
      // Base64画像データ
      return result.output;
    } else if (result.output.startsWith('http')) {
      // 画像URL
      return result.output;
    } else {
      throw new Error('無効な出力形式');
    }
  } catch (error) {
    console.error('写真復元エラー:', error);
    throw error;
  }
}
 
// 使用
const restoredImage = await restorePhoto(
  'https://example.com/old-photo.jpg',
  'your-api-key-here'
);
console.log('復元された画像:', restoredImage);

cURL

curl -X POST https://restoreoldphotos.online/api/api-call/photo-restore \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "imageUrl": "https://example.com/old-photo.jpg"
  }'

画像要件

  • 形式: JPG、PNG、WebP
  • サイズ: 最大5MB
  • アクセス性: 画像URLは公開アクセス可能である必要があります
  • 内容: 有効な画像ファイルである必要があります

処理時間

  • 通常: 10-30秒
  • 大きな画像: 最大60秒かかる場合があります

クレジット

  • コスト: 復元1回につき1クレジット
  • 控除: 成功した処理後にクレジットが控除されます

ベストプラクティス

  1. 画像品質: より良い結果のために高品質の画像を使用
  2. エラー処理: 適切なエラー処理を常に実装
  3. クレジット管理: クレジット残高を定期的に監視
  4. 出力処理: 出力は常に文字列で、ストリーム処理は不要

トラブルシューティング

一般的な問題

401 Unauthorized

  • APIキーが正しいか確認
  • APIキーがアクティブで期限切れでないことを確認

402 Payment Required

  • アカウントにクレジットを追加
  • 現在のクレジット残高を確認

400 Bad Request

  • imageUrlが有効でアクセス可能なURLか確認
  • 画像形式がサポートされているか確認

無効な出力形式

  • 出力は常に文字列(URLまたはbase64)である必要があります
  • APIレスポンスに期待される出力フィールドが含まれているか確認

429 Too Many Requests

  • 1時間あたり100リクエストのレート制限を超えました
  • より多くのリクエストを行う前にレート制限ウィンドウがリセットされるまで待機

サポート

ここでカバーされていない問題が発生した場合は、サポートチームにお問い合わせください。