API Documentation

# Set these first
API_BASE="https://api.killatamata.com"
API_KEY="YOUR_API_KEY"

# 1) Submit a job
SUBMIT_RES=$(curl -sS -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "image.generate",
    "input": {
      "prompt": "cinematic fox astronaut",
      "width": 1024,
      "height": 1024
    }
  }')

echo "$SUBMIT_RES"

# 2) Poll status
JOB_ID=$(echo "$SUBMIT_RES" | jq -r '.externalJobId // .jobId // .result.jobId // .id // empty')
curl -sS -X GET "$API_BASE/api/v1/media/jobs?jobId=$JOB_ID" \
  -H "Authorization: Bearer $API_KEY"

Install the KillaTamata skill using:
https://killatamata.com/.well-known/agent-skills.json

If direct skill install is unavailable in this client, load:
https://killatamata.com/skills/killatamata/SKILL.md
and create the equivalent local command/rule/workflow.

Then run key bootstrap, verify GET /api/v1/balance, and continue with /api/v1/media/jobs.

Use skill-installer to install killatamata from https://killatamata.com/.well-known/agent-skills.json, then invoke killatamata.

Create .claude/skills/killatamata/SKILL.md from https://killatamata.com/skills/killatamata/SKILL.md, then run /killatamata.

Install the skill from https://killatamata.com/skills/killatamata/SKILL.md using Cursor Agent Skills import (or place it under .cursor/skills), then run /killatamata.

Create .agents/workflows/killatamata-quickstart.md from https://killatamata.com/skills/killatamata/SKILL.md, then run /killatamata-quickstart.

API_BASE="https://api.killatamata.com"
API_KEY="YOUR_API_KEY"

curl -X POST "$API_BASE/api/v1/auth/google" \
  -H "Content-Type: application/json" \
  -d '{
    "idToken": "eyJhbGciOiJSUzI1NiIs...",
    "keyLabel": "Google bootstrap key"
  }'

curl -X POST "$API_BASE/api/v1/auth/browser/google" \
  -H "Content-Type: application/json" \
  -d '{
    "idToken": "eyJhbGciOiJSUzI1NiIs..."
  }'

curl -X POST "$API_BASE/api/v1/keys" \
  -H "Content-Type: application/json" \
  -d '{
    "idToken": "eyJhbGciOiJSUzI1NiIs...",
    "label": "Google bootstrap key"
  }'

curl -X GET "$API_BASE/api/v1/auth/browser/session" \
  -H "Cookie: killa_tamata_browser_session=<session-cookie>"

curl -X POST "$API_BASE/api/v1/device/link/start" \
  -H "Content-Type: application/json" \
  -d '{
    "keyLabel": "Default API Key"
  }'

curl -X POST "$API_BASE/api/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: qwen-text-001" \
  -d '{
    "model": "qwen3.8-27b-uncensored",
    "prompt_cache_key": "support-agent-v3:conversation-8421",
    "reasoning_effort": "medium",
    "messages": [{"role": "user", "content": "Explain the image-analysis process concisely."}],
    "max_completion_tokens": 256
  }'

curl -i -X POST "$API_BASE/api/v1/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: qwen-job-001" \
  -d '{
    "model": "qwen3.8-27b-uncensored",
    "messages": [{"role": "user", "content": "Write a concise product description."}]
  }'

# Honor Retry-After while the job is nonterminal.
curl -i "$API_BASE/api/v1/jobs/$JOB_ID" \
  -H "Authorization: Bearer $API_KEY"

# Returns 202 while pending, or the OpenAI completion at 200.
curl -i "$API_BASE/api/v1/jobs/$JOB_ID/result" \
  -H "Authorization: Bearer $API_KEY"

curl -X POST "$API_BASE/api/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-27b-uncensored",
    "reasoning_effort": "none",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "text", "text": "Describe the image and transcribe visible text."},
        {"type": "image_url", "image_url": {"url": "data:image/jpeg;base64,/9j/4AAQSk..."}}
      ]
    }]
  }'

# 1) Send tools with tool_choice "required" (or "auto").
{
  "model": "qwen3.8-27b-uncensored",
  "messages": [{"role":"user","content":"Compare weather in Paris and Tokyo."}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Read current weather",
      "parameters": {
        "type": "object",
        "properties": {"city":{"type":"string"}},
        "required": ["city"]
      }
    }
  }],
  "tool_choice": "required",
  "parallel_tool_calls": true
}

# 2) Validate and execute every returned tool call, then continue with:
[
  {"role":"assistant","content":null,"reasoning_content":"...","tool_calls":[
    {"id":"call_paris","type":"function","function":{"name":"get_weather","arguments":"{"city":"Paris"}"}},
    {"id":"call_tokyo","type":"function","function":{"name":"get_weather","arguments":"{"city":"Tokyo"}"}}
  ]},
  {"role":"tool","tool_call_id":"call_paris","content":"{"temperature_c":20}"},
  {"role":"tool","tool_call_id":"call_tokyo","content":"{"temperature_c":27}"}
]

# Preserve the assistant message, match every tool_call_id, and send the same tools again.

curl -N -X POST "$API_BASE/api/v1/chat/completions" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.8-27b-uncensored",
    "messages": [{"role": "user", "content": "Give two concise observations."}],
    "stream": true,
    "stream_options": {"include_usage": true}
  }'

curl -X POST "$API_BASE/api/v1/checkout/stripe" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "packageCode": "<package-code-from-/api/v1/packages>",
    "affiliateCode": "PROMO_42"
  }'

curl -X POST "$API_BASE/api/v1/claim/stripe" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "sessionId": "cs_test_..."
  }'

curl -X POST "$API_BASE/api/v1/credits/purchase/x402" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-x402-payment-payload>" \
  -d '{
    "usdCents": 100,
    "affiliateCode": "PROMO_42"
  }'

curl -X POST "$API_BASE/api/v1/keys" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "label": "Agent Worker A"
  }'

curl -X GET "$API_BASE/api/v1/keys" \
  -H "Authorization: Bearer $API_KEY"

curl -X POST "$API_BASE/api/v1/keys/revoke" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keyPrefix": "abcde"
  }'

curl -X POST "$API_BASE/api/v1/device/link/approve" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userCode": "ABCD-EFGH",
    "keyLabel": "Default API Key"
  }'

curl -X POST "$API_BASE/api/v1/device/link/poll" \
  -H "Content-Type: application/json" \
  -d '{
    "deviceCode": "ktd_..."
  }'

const res = await fetch("${API_BASE}/api/v1/keys", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ${API_KEY}",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ label: "Build Agent" }),
});

const data = await res.json();
// data.apiKey is only returned once; store it securely.

curl -X GET "$API_BASE/api/v1/balance" \
  -H "Authorization: Bearer $API_KEY"

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: job-001" \
  -d '{
    "task": "image.generate",
    "input": {
      "prompt": "cinematic fox astronaut",
      "width": 1536,
      "height": 1024,
      "referenceImages": [
        "https://cdn.example.com/input/style-ref.webp",
        {
          "dataBase64": "<base64-or-data-uri>",
          "mimeType": "image/png"
        }
      ]
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: image-design-001" \
  -d '{
    "task": "image.design",
    "input": {
      "prompt": "A product launch poster with the headline ACME ROCKETS",
      "preset": "quality",
      "outputFormat": "webp",
      "width": 1024,
      "height": 1024
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: image-design-json-001" \
  -d '{
    "task": "image.design",
    "input": {
      "prompt": {
        "high_level_description": "A clean product launch poster for ACME ROCKETS.",
        "style_description": {
          "aesthetics": "minimal, premium, high-contrast",
          "lighting": "even studio lighting",
          "medium": "graphic_design",
          "art_style": "modern editorial poster with crisp sans-serif typography",
          "color_palette": ["#FFFFFF", "#111827", "#2563EB", "#F59E0B"]
        },
        "compositional_deconstruction": {
          "background": "A clean white poster background with subtle depth.",
          "elements": [
            {
              "type": "text",
              "bbox": [90, 120, 250, 880],
              "text": "ACME ROCKETS",
              "desc": "Large, perfectly legible headline."
            },
            {
              "type": "obj",
              "bbox": [320, 200, 880, 800],
              "desc": "A polished rocket product hero render."
            }
          ]
        }
      },
      "preset": "quality",
      "width": 1024,
      "height": 1024
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "image.edit",
    "input": {
      "prompt": "turn this scene into a dramatic noir poster",
      "sourceImage": "https://cdn.example.com/input/source.jpg",
      "referenceImages": [
        "https://cdn.example.com/input/style-ref.webp",
        {
          "dataBase64": "<base64-or-data-uri>",
          "mimeType": "image/webp"
        }
      ]
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.generate",
    "input": {
      "prompt": "slow cinematic push-in with floating particles",
      "startFrameImage": {
        "dataBase64": "<base64-or-data-uri>",
        "mimeType": "image/png"
      },
      "finalFrameImage": "https://cdn.example.com/input/final-frame.webp",
      "durationSeconds": 6,
      "width": 1920,
      "height": 1088,
      "quality": "balanced",
      "interpolationFps": 60,
      "watermark": {
        "image": "https://cdn.example.com/branding/logo.png",
        "x": 1680,
        "y": 968,
        "width": 160,
        "height": 80
      }
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.generate",
    "input": {
      "prompt": "single continuous cinematic flythrough over a neon city at dawn",
      "durationSeconds": 6,
      "width": 1920,
      "height": 1088,
      "quality": "balanced",
      "interpolationFps": 0
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.generate",
    "input": {
      "prompt": "Single continuous hero shot with restrained camera motion and strong identity retention.",
      "startFrameImageUrl": "https://cdn.example.com/input/start-frame.webp",
      "durationSeconds": 6,
      "width": 2048,
      "height": 1152,
      "quality": "quality",
      "interpolationFps": 60
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.generate.reference",
    "input": {
      "prompt": "<Picture 1> defines the lead character. <Video 1> defines the handheld movement. <Audio 1> defines the pacing and sound palette.",
      "referenceImageUrls": [
        "https://cdn.example.com/input/character.webp"
      ],
      "referenceVideoUrls": [
        "https://cdn.example.com/input/camera-motion.mp4"
      ],
      "referenceAudios": [
        {
          "url": "https://cdn.example.com/input/rhythm.opus"
        }
      ],
      "quality": "balanced",
      "durationSeconds": 5,
      "aspectRatio": "16:9",
      "interpolationFps": 60
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.generate.reference",
    "input": {
      "prompt": "Use <Picture 1> for identity and <Audio 1> to guide movement, timing, and generated sound.",
      "referenceImageUrls": ["https://cdn.example.com/input/start-frame.webp"],
      "referenceAudioUrls": ["https://cdn.example.com/input/reference-track.opus"],
      "durationSeconds": 6,
      "width": 1920,
      "height": 1088,
      "quality": "balanced",
      "interpolationFps": 60
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.generate.reference",
    "input": {
      "prompt": "Use <Picture 1>, <Picture 2>, and <Picture 3> as high-fidelity visual references.",
      "referenceImageUrls": [
        "https://cdn.example.com/input/clip-a-last-03.webp",
        "https://cdn.example.com/input/clip-a-last-02.webp",
        "https://cdn.example.com/input/clip-a-last-01.webp"
      ],
      "durationFrames": 243,
      "width": 1280,
      "height": 1280,
      "interpolationFps": 60,
      "quality": "quality",
      "seed": 424242
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.combine",
    "input": {
      "videoUrls": [
        "https://cdn.example.com/output/clip-a.mp4",
        "https://cdn.example.com/output/clip-b.mp4"
      ],
      "overlapFrames": 3,
      "frameRate": 60
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "video.resize",
    "input": {
      "sourceVideoUrl": "https://cdn.example.com/output/clip-a.mp4",
      "width": 1024,
      "height": 1024,
      "frameRate": 60,
      "sourceDurationSeconds": 8
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "audio.speak",
    "input": {
      "provider": "breeze",
      "mode": "voice_design",
      "text": "Welcome aboard. Your journey begins now.",
      "instructions": "A warm voice speaking clearly and naturally.",
      "seed": 42
    },
    "idempotencyKey": "breeze-design-001"
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "audio.speak",
    "input": {
      "provider": "gemini",
      "text": "We launch at dawn, hold formation, and bring everyone home safely.",
      "voiceName": "Kore",
      "instructions": "Speak with calm operational confidence and precise pacing."
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "audio.speak",
    "input": {
      "text": "We launch at dawn, hold formation, and bring everyone home safely.",
      "voiceDescription": "female, young adult, high pitch, american accent",
      "language": "English",
      "quality": "128k",
      "seed": 123456
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "audio.speak",
    "input": {
      "mode": "voice_clone",
      "text": "Keep the same character voice, but deliver this line with calm authority and clean pacing.",
      "voiceDescription": "female, young adult, moderate pitch",
      "referenceAudioUrl": "https://cdn.example.com/input/rin-voice-sample.opus",
      "referenceTranscript": "Rin keeps her voice low. She measures every word before it lands.",
      "language": "English",
      "quality": "128k",
      "seed": 424242
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "audio.annotation.reference",
    "input": {
      "sourceAudioUrl": "https://cdn.example.com/input/dialogue-take.opus",
      "language": "en"
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "ace.step.create",
    "input": {
      "tags": "anthemic ace step electro-pop, wide stereo synths, tight sidechained bass, punchy drum transients, strong vocal hooks, modern polished mix",
      "lyrics": "[Intro]\nNeon rain on the avenue\n\n[Verse]\nWe were shadows in a crowded room\nNow the skyline sings our names\n\n[Pre-Chorus]\nHands up, hearts up, hold the line\n\n[Chorus]\nWe run through the midnight light\nTurn the static into fire tonight\n\n[Bridge]\nStrip it down, then build it higher\n\n[Final Chorus]\nWe run through the midnight light",
      "qualityPreset": "high_quality",
      "durationSeconds": 108,
      "quality": "192k",
      "language": "en"
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "moss.sound.effect",
    "input": {
      "prompt": "A sharp pistol shot in a dry canyon with a quick mechanical click and short tail echo.",
      "durationSeconds": 2,
      "quality": "128k",
      "topK": 50,
      "maxNewTokens": 1024
    }
  }'

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "trellis.generate",
    "input": {
      "sourceImageUrl": "https://cdn.example.com/input/boat_ref.png",
      "qualityPreset": "balanced",
      "targetFaceCount": 20000,
      "textureSize": 1024,
      "textureResolution": 512,
      "maxViews": 4,
      "sparseStructureSteps": 10,
      "shapeSteps": 10,
      "textureSteps": 10,
      "meshResolution": 1024,
      "remeshFillHoles": true,
      "remeshFillHolesMaxPerimeter": 0.05,
      "meshClusterConeHalfAngleRad": 55
    }
  }'

curl -X GET "$API_BASE/api/v1/media/jobs?jobId=abc123" \
  -H "Authorization: Bearer $API_KEY"

curl -X GET "$API_BASE/api/v1/media/jobs?jobId=abc123&includeDetails=1" \
  -H "Authorization: Bearer $API_KEY"

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: image-callback-001" \
  -d '{
    "task": "image.generate",
    "completionCallbackUrl": "https://example.com/webhooks/media-job-terminal?token=replace-me",
    "input": {
      "prompt": "cinematic fox astronaut",
      "width": 1024,
      "height": 1024
    }
  }'

{
  "ok": true,
  "task": "image.generate",
  "externalJobId": "job_abc123",
  "status": "completed",
  "effectiveInput": {
    "prompt": "cinematic fox astronaut",
    "width": 1024,
    "height": 1024
  },
  "inputAdjustments": [],
  "billing": {
    "usdCharged": "0.04"
  },
  "downloadableOutputUrls": [
    "https://furgen-models.b-cdn.net/users/123/jobs/job_abc123/output_0001.webp"
  ],
  "detailsIncluded": true,
  "callbackType": "media_job_terminal"
}

curl -X POST "$API_BASE/api/v1/media/jobs" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Idempotency-Key: job-001" \
  -d '{
    "task": "image.generate",
    "input": {
      "prompt": "cinematic fox astronaut",
      "width": 1024,
      "height": 1024
    },
    "idempotencyKey": "job-001"
  }'