Media Generation

Base URL https://spideriq.ai/api/gate/v1

POST /api/gate/v1/media/generations

Generate Media (schema-aware)

Generate an image, video, or audio clip through SpiderGate's adapter-backed, schema-aware pipeline. Unlike ``/v1/images`` + ``/v1/audio`` (raw OpenAI passthrough), this honors each model's declared ``inputs`` and returns a SpiderMedia-stored URL plus a cost breakdown. Discover models + their tunables via ``GET /api/gate/v1/media/models``.

Responses

200Media generated; returns stored URL + cost breakdown
400Invalid request
401Authentication error
404Unknown media model
429Rate limit exceeded
500Internal error
502Provider generation failed
503No provider key available for this brand
422Validation Error

POST /api/gate/v1/media/generations

curl -X POST 'https://spideriq.ai/api/gate/v1/media/generations' \
  -H 'Authorization: Bearer ' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "kie/veo-3-fast",
  "params": {
    "prompt": "A spider weaving a gate, cinematic",
    "aspect_ratio": "16:9"
  }
}'

import httpx

resp = httpx.post(
    "https://spideriq.ai/api/gate/v1/media/generations",
    headers={"Authorization": "Bearer ", "Content-Type": "application/json"},
    json={"model": "kie/veo-3-fast", "params": {"prompt": "A spider weaving a gate, cinematic", "aspect_ratio": "16:9"}},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://spideriq.ai/api/gate/v1/media/generations", {
  method: "POST",
  headers: { "Authorization": "Bearer ", "Content-Type": "application/json" },
  body: JSON.stringify({"model": "kie/veo-3-fast", "params": {"prompt": "A spider weaving a gate, cinematic", "aspect_ratio": "16:9"}})
});
const data = await resp.json();
console.log(data);

package main

import (
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{"model": "kie/veo-3-fast", "params": {"prompt": "A spider weaving a gate, cinematic", "aspect_ratio": "16:9"}}`)
	req, _ := http.NewRequest("POST", "https://spideriq.ai/api/gate/v1/media/generations", body)
	req.Header.Set("Authorization", "Bearer ")
	req.Header.Set("Content-Type", "application/json")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}

Request body

{"model":"kie/veo-3-fast","params":{"prompt":"A spider weaving a gate, cinematic","aspect_ratio":"16:9"}}

GET /api/gate/v1/media/models

List Media Models

List the media-generation models an agent can call, each with its declared ``inputs`` schema (the per-model tunables + their type/enum/min/max). This is the discovery surface — read a model's ``inputs`` BEFORE calling ``POST /media/generations`` so you only pass params the model accepts (undeclared params are dropped).

Parameters

modality any query

Filter to one modality (text-to-image | text-to-video | tts | stt | …).

include_inactive boolean query

Also return coming_soon/disabled models (not generatable yet).

Responses

200Successful Response
422Validation Error

GET /api/gate/v1/media/models

curl -X GET 'https://spideriq.ai/api/gate/v1/media/models' \
  -H 'Authorization: Bearer '

import httpx

resp = httpx.get(
    "https://spideriq.ai/api/gate/v1/media/models",
    headers={"Authorization": "Bearer "},
)
resp.raise_for_status()
print(resp.json())

const resp = await fetch("https://spideriq.ai/api/gate/v1/media/models", {
  method: "GET",
  headers: { "Authorization": "Bearer " }
});
const data = await resp.json();
console.log(data);

package main

import (
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://spideriq.ai/api/gate/v1/media/models", nil)
	req.Header.Set("Authorization", "Bearer ")
	resp, _ := http.DefaultClient.Do(req)
	defer resp.Body.Close()
}