Skip to content
Console
RUTY / DEVELOPERS

From zero to your first call.

Ruty brings ReelMind and Yiha’s image and video infrastructure into one developer interface. Use the same account and API key across REST, MCP and CLI.

01. Get a key

Sign in to the console with your existing account, or create one. Create an API key and add credits before submitting generation requests.

terminal
export RUTY_API_KEY="YOUR_API_KEY"

02. Discover and price

Get current models and a quote for the exact settings you intend to use. Account pricing can differ from the public catalog.

terminal
curl https://ruty.ai/v1/models \
  -H "Authorization: Bearer $RUTY_API_KEY"

curl https://ruty.ai/v1/prices \
  -H "Authorization: Bearer $RUTY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model_id":"gpt-image-2","resolution":"1K","num_images":1}'

03. Create an image

terminal
curl https://ruty.ai/v1/images \
  -H "Authorization: Bearer $RUTY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "model_id": "gpt-image-2",
    "prompt": "A quiet observatory above the clouds",
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "num_images": 1
  }'

Save the returned data.task_id, then retrieve it with GET /v1/images/{task_id}. Results are asynchronous.

Save your image idempotency key and reuse it when retrying the same request. Generate a new key for a new task.