# HedaAI Product Images API

> HedaAI generates 12 professional e-commerce images (8 main images + 4 A+ banners) plus complete listing copy from product photos. $1.00 per product, charged only on success. Asynchronous REST API (create task → poll → fetch product) plus a hosted MCP server for AI agents.

- Base URL: https://hedaai.com/api/v1
- Auth: `Authorization: Bearer hda_live_...` — create keys at https://hedaai.com/settings/api-keys
- MCP endpoint (Streamable HTTP): https://hedaai.com/api/v1/mcp — tools: create_product_shoot, get_task, get_product, get_balance

## Docs

- [Full API reference (markdown)](https://hedaai.com/developers/api.md): authentication, endpoints, idempotency, webhooks, rate limits, error codes, code examples (curl/Python/Node/PHP/Java/Go), MCP setup, pricing
- [Developer docs (HTML)](https://hedaai.com/developers): also served in German, French, Spanish, Simplified Chinese, Traditional Chinese, Japanese and Korean at https://hedaai.com/{de,fr,es,zh-cn,zh-tw,ja,ko}/developers — this markdown mirror and llms.txt stay English

## Key facts

- Required task fields: product_name, images (1-8 URLs or base64), aspect_ratio (1:1, 2:3, 3:2, 3:4, 4:3, 9:16, 16:9)
- Task statuses: queued → processing → succeeded | partial_failed | failed | canceled; failed/partial tasks are never charged
- Typical generation time ~10 minutes; poll GET /v1/tasks/{id} every 15-30s or use callback_url webhooks (Standard Webhooks signatures)
- Idempotency-Key header supported on task creation (same key + same body replays the same task; conflict = HTTP 409)
- Limits: 120 requests/min per key, 2 in-flight tasks per key
- Accounts without a real payment get watermarked output (free sandbox); first payment removes watermarks retroactively