HedaAI Product Images API

API=https://hedaai.com/api/v1

# 1. Create a task
TASK_ID=$(curl -sS -X POST "$API/tasks" \
  -H "Authorization: Bearer $HEDAAI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: sku-8842-v1" \
  -d '{"product_name":"stainless steel insulated water bottle",
       "images":["https://your-cdn.example.com/bottle.jpg"],
       "aspect_ratio":"1:1"}' | jq -r .data.task_id)

# 2. Poll until terminal
while :; do
  TASK=$(curl -sS -H "Authorization: Bearer $HEDAAI_API_KEY" "$API/tasks/$TASK_ID")
  STATUS=$(echo "$TASK" | jq -r .data.status)
  [ "$STATUS" = "queued" ] || [ "$STATUS" = "processing" ] || break
  sleep 20
done

# 3. Fetch images + listing copy
if [ "$STATUS" = "succeeded" ]; then
  PRODUCT_ID=$(echo "$TASK" | jq -r .data.product_id)
  curl -sS -H "Authorization: Bearer $HEDAAI_API_KEY" "$API/products/$PRODUCT_ID" \
    | jq -r '.data.images[].url, .data.listing_copy.title'
fi

import time, requests

API = "https://hedaai.com/api/v1"
H = {"Authorization": "Bearer hda_live_..."}

# 1. Create a task
task = requests.post(f"{API}/tasks",
    headers={**H, "Idempotency-Key": "sku-8842-v1"},
    json={"product_name": "stainless steel insulated water bottle",
          "images": ["https://your-cdn.example.com/bottle.jpg"],
          "aspect_ratio": "1:1"}).json()["data"]

# 2. Poll until terminal
while task["status"] in ("queued", "processing"):
    time.sleep(20)
    task = requests.get(f"{API}/tasks/{task['task_id']}", headers=H).json()["data"]

# 3. Fetch images + listing copy
if task["status"] == "succeeded":
    product = requests.get(f"{API}/products/{task['product_id']}", headers=H).json()["data"]
    print([img["url"] for img in product["images"]])
    print(product["listing_copy"]["title"])

const API = "https://hedaai.com/api/v1";
const H = { Authorization: "Bearer hda_live_...", "Content-Type": "application/json" };

// 1. Create a task
let { data: task } = await (await fetch(`${API}/tasks`, {
  method: "POST",
  headers: { ...H, "Idempotency-Key": "sku-8842-v1" },
  body: JSON.stringify({
    product_name: "stainless steel insulated water bottle",
    images: ["https://your-cdn.example.com/bottle.jpg"],
    aspect_ratio: "1:1",
  }),
})).json();

// 2. Poll until terminal
while (["queued", "processing"].includes(task.status)) {
  await new Promise(r => setTimeout(r, 20000));
  ({ data: task } = await (await fetch(`${API}/tasks/${task.task_id}`, { headers: H })).json());
}

// 3. Fetch images + listing copy
if (task.status === "succeeded") {
  const { data: product } = await (await fetch(`${API}/products/${task.product_id}`, { headers: H })).json();
  console.log(product.images.map(i => i.url), product.listing_copy.title);
}

package main

import (
	"bytes"
	"encoding/json"
	"fmt"
	"net/http"
	"time"
)

const api = "https://hedaai.com/api/v1"

type envelope struct {
	Data struct {
		TaskID    string `json:"task_id"`
		Status    string `json:"status"`
		ProductID string `json:"product_id"`
		Images    []struct {
			URL string `json:"url"`
		} `json:"images"`
		ListingCopy struct {
			Title string `json:"title"`
		} `json:"listing_copy"`
	} `json:"data"`
}

func call(method, url string, body []byte, extra map[string]string) (envelope, error) {
	var out envelope
	var rdr *bytes.Reader
	if body != nil {
		rdr = bytes.NewReader(body)
	} else {
		rdr = bytes.NewReader(nil)
	}
	req, err := http.NewRequest(method, url, rdr)
	if err != nil {
		return out, err
	}
	req.Header.Set("Authorization", "Bearer hda_live_...")
	req.Header.Set("Content-Type", "application/json")
	for k, v := range extra {
		req.Header.Set(k, v)
	}
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		return out, err
	}
	defer resp.Body.Close()
	return out, json.NewDecoder(resp.Body).Decode(&out)
}

func main() {
	// 1. Create a task
	payload, _ := json.Marshal(map[string]any{
		"product_name": "stainless steel insulated water bottle",
		"images":       []string{"https://your-cdn.example.com/bottle.jpg"},
		"aspect_ratio": "1:1",
	})
	task, err := call("POST", api+"/tasks", payload,
		map[string]string{"Idempotency-Key": "sku-8842-v1"})
	if err != nil {
		panic(err)
	}

	// 2. Poll until terminal
	for task.Data.Status == "queued" || task.Data.Status == "processing" {
		time.Sleep(20 * time.Second)
		if task, err = call("GET", api+"/tasks/"+task.Data.TaskID, nil, nil); err != nil {
			panic(err)
		}
	}

	// 3. Fetch images + listing copy
	if task.Data.Status == "succeeded" {
		product, err := call("GET", api+"/products/"+task.Data.ProductID, nil, nil)
		if err != nil {
			panic(err)
		}
		for _, img := range product.Data.Images {
			fmt.Println(img.URL)
		}
		fmt.Println(product.Data.ListingCopy.Title)
	}
}

import java.net.URI;
import java.net.http.*;
import java.time.Duration;
import com.fasterxml.jackson.databind.*; // any JSON library works

public class HedaAI {
    static final String API = "https://hedaai.com/api/v1";
    static final HttpClient CLIENT = HttpClient.newHttpClient();
    static final ObjectMapper MAPPER = new ObjectMapper();

    static JsonNode call(HttpRequest.Builder b) throws Exception {
        HttpRequest req = b.header("Authorization", "Bearer hda_live_...")
                           .header("Content-Type", "application/json")
                           .build();
        String body = CLIENT.send(req, HttpResponse.BodyHandlers.ofString()).body();
        return MAPPER.readTree(body).path("data");
    }

    public static void main(String[] args) throws Exception {
        // 1. Create a task
        JsonNode task = call(HttpRequest.newBuilder(URI.create(API + "/tasks"))
            .header("Idempotency-Key", "sku-8842-v1")
            .POST(HttpRequest.BodyPublishers.ofString("""
                {"product_name":"stainless steel insulated water bottle",
                 "images":["https://your-cdn.example.com/bottle.jpg"],
                 "aspect_ratio":"1:1"}""")));

        // 2. Poll until terminal
        String status = task.path("status").asText();
        while (status.equals("queued") || status.equals("processing")) {
            Thread.sleep(Duration.ofSeconds(20));
            task = call(HttpRequest.newBuilder(
                URI.create(API + "/tasks/" + task.path("task_id").asText())).GET());
            status = task.path("status").asText();
        }

        // 3. Fetch images + listing copy
        if (status.equals("succeeded")) {
            JsonNode product = call(HttpRequest.newBuilder(
                URI.create(API + "/products/" + task.path("product_id").asText())).GET());
            product.path("images").forEach(img -> System.out.println(img.path("url").asText()));
            System.out.println(product.path("listing_copy").path("title").asText());
        }
    }
}

<?php
$api = "https://hedaai.com/api/v1";
$headers = ["Authorization: Bearer hda_live_...", "Content-Type: application/json"];

function call($method, $url, $headers, $body = null) {
    $ch = curl_init($url);
    curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CUSTOMREQUEST => $method, CURLOPT_HTTPHEADER => $headers]);
    if ($body !== null) curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($body));
    $res = json_decode(curl_exec($ch), true); curl_close($ch);
    return $res["data"];
}

// 1. Create a task
$task = call("POST", "$api/tasks", array_merge($headers, ["Idempotency-Key: sku-8842-v1"]), [
    "product_name" => "stainless steel insulated water bottle",
    "images" => ["https://your-cdn.example.com/bottle.jpg"],
    "aspect_ratio" => "1:1",
]);

// 2. Poll until terminal
while (in_array($task["status"], ["queued", "processing"])) {
    sleep(20);
    $task = call("GET", "$api/tasks/{$task['task_id']}", $headers);
}

// 3. Fetch images + listing copy
if ($task["status"] === "succeeded") {
    $product = call("GET", "$api/products/{$task['product_id']}", $headers);
    foreach ($product["images"] as $img) echo $img["url"], "\n";
    echo $product["listing_copy"]["title"], "\n";
}

claude mcp add --transport http hedaai https://hedaai.com/api/v1/mcp \
  --header "Authorization: Bearer $HEDAAI_API_KEY"

{
  "mcpServers": {
    "hedaai": {
      "url": "https://hedaai.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer hda_live_..." }
    }
  }
}