API Reference

IMG2VOICE-API-KEY: sk_live_your_api_key_here

curl -X POST https://api.img2voice.com/v1 \
  -H "IMG2VOICE-API-KEY: sk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://example.com/photo.png",
    "voice_id": "eve",
    "language": "en",
    "detail": "standard",
    "output_format": "mp3"
  }'

import requests
import json

response = requests.post(
    "https://api.img2voice.com/v1",
    headers={
        "IMG2VOICE-API-KEY": "sk_live_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "image_url": "https://example.com/photo.png",
        "voice_id": "eve",
        "language": "en",
        "detail": "standard",
        "output_format": "mp3",
    },
    timeout=15,
)
response.raise_for_status()
data = response.json()

print(data["description"])               # e.g. "A sunny beach with waves"
print(data["audio_url"])                 # Stream or download this URL
print(data["duration_seconds"])          # e.g. 3.2
print(data["image_credits_used"])        # 1
print(data["image_credits_remaining"])   # credits left

async function uploadImage(file: File): Promise<void> {
  const formData = new FormData();
  formData.append("image", file);  // field must be named "image"
  formData.append("voice_id", "eve");
  formData.append("language", "en");
  formData.append("detail", "standard");

  const res = await fetch("https://api.img2voice.com/v1", {
    method: "POST",
    headers: {
      "IMG2VOICE-API-KEY": process.env.IMG2VOICE_API_KEY!,
      // Do NOT set Content-Type — the browser sets it with the boundary
    },
    body: formData,
  });

  if (!res.ok) {
    const error = await res.json();
    throw new Error(`Error: ${error.error.code} - ${error.error.message}`);
  }

  const data = await res.json();
  console.log(data.description);             // AI description
  console.log(data.audio_url);               // Download or stream
  console.log(data.image_credits_remaining); // Credits left
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "You have exceeded 200 requests per minute. Retry after 18 seconds.",
    "retry_after": 18
  }
}