Optimize Prompt

POST /api/v1/agent/optimize-prompt

Headers: X-API-Key: h3k_...

Body:

{
  "prompt": "a golden retriever running in a wheat field, sunny",
  "duration": 5,
  "resolution": "480p",
  "aspect_ratio": "16:9",
  "model": "t2v",
  "ref_media_ids": []
}

ref_media_ids accepts reference media IDs, up to 15.

Response:

{
  "optimized_prompt": "...",
  "latency_ms": 1234
}

The optimized prompt can be passed directly as prompt in video/generate.

Generate Tags

POST /api/v1/agent/generate-tags

Headers: X-API-Key: h3k_...

Body:

{
  "prompt": "a golden retriever running in a wheat field"
}

Response:

{
  "tags": ["golden retriever", "wheat field", "animals", "nature"],
  "latency_ms": 800
}

Tag generation failure does not block publishing; the frontend can ignore it and let the user fill tags manually.