Models

How to discover, select, and use models on dryAPI

dryAPI gives you a unified API across multiple open-source models running on a decentralized GPU cloud. We regularly expand the model lineup — new models, new capabilities, better performance — so your integration can always take advantage of the latest options.

The Model Selection endpoint returns the live, authoritative list of all available models, their slugs, limits, and defaults. Use it as the starting point for every integration.

TIP

This page explains how model selection works and how to use the endpoint. For the actual list of models and their exact slugs, always refer to the Model Selection endpoint.

Fetching the live model list

Before you start building, call the models endpoint to discover what's available:

curl -X GET "https://api.dryapi.dev/api/v1/client/models" \
  -H "Authorization: Bearer $DRYAPI_API_KEY" \
  -H "Accept: application/json"

The response returns a paginated data array of model objects. Each object contains:

NOTE

Not every model returns all fields. For example, a transcription model may return an empty info, while an image-generation model will include detailed limits, features, and defaults. Always check for the presence of fields before using them.

You can filter the list by task type using the filter[inference_types] query parameter:

# Get only image-generation models
curl -X GET "https://api.dryapi.dev/api/v1/client/models?filter[inference_types]=txt2img" \
  -H "Authorization: Bearer $DRYAPI_API_KEY" \
  -H "Accept: application/json"

See the full endpoint spec → Model Selection

How model selection works

• Every task endpoint requires a model parameter. Pass the slug value returned by the models endpoint — not the display name.
• Quality ↔ Speed trade-off. Larger models often yield higher quality but cost more and take longer. See the Pricing page for per-task rates.
• Versioning & lifecycle. Models may be updated, superseded, or deprecated. Re-fetch the model list periodically to stay current.

Supported tasks

The table below shows which task types dryAPI supports. To see which models are currently available for a given task, query the models endpoint with the corresponding filter[inference_types] value.

NOTE

Some models support multiple tasks (e.g. both txt2img and img2img). The models endpoint will list all supported inference_types for each model.

Choosing the right model

When the models endpoint returns several options for the same task, use these guidelines:

Image generation — Start with the fastest model for iteration. Increase steps and resolution for final quality. If the model object includes a non-empty loras array, you can use LoRA adapters for style control.

Speech generation (TTS) — Check the model's languages array for available languages and voices. Use info.defaults for recommended speed and format settings. The endpoint supports three modes: custom_voice (preset speakers), voice_clone (clone from reference audio), and voice_design (create voice from a text description). Not all models support all modes — check model capabilities before selecting a mode.

Music generation — Provide a text description (caption) of the desired music style. Optionally include lyrics (use "[Instrumental]" for instrumental tracks), bpm, keyscale, and timesignature to fine-tune the output. You can also upload a reference_audio file for style transfer. Check info.limits for supported duration range and inference steps. Use fewer steps with turbo models (e.g. 8) and more steps with base models (e.g. 32+).

Transcription (Video/Audio-to-Text) — Transcription models support both URL-based and file-upload transcription. For long content, enable timestamps (include_ts: true). URL-based transcription works with YouTube, Twitch, Kick, TikTok and X/Twitter.

OCR (Image-to-Text) — Check info.limits for the maximum supported image dimensions. For complex layouts, consider multiple passes or post-processing.

Video generation — Start with low frame counts to validate aesthetics, then scale up. Check info.limits.max_frames, min_frames, and max_fps for each model. Some models support a last_frame feature (see info.features.supports_last_frame). For audio-to-video, provide an audio file to condition the video generation alongside your text prompt — some models (e.g. LTX 2.3) support txt2video, img2video, and aud2video tasks.

Embeddings — Check info.limits.max_input_tokens and max_total_tokens for batch sizing. Use for semantic search, clustering, and retrieval-augmented generation (RAG).

Background removal — Check info.limits.max_width and max_height for the maximum supported resolution.

Image upscale — Check info.limits for input size constraints.

Parameter limits & resolution rules

Each model defines its own limits in the info.limits object. These limits vary between models and task types. Common fields include:

• Dimensions: min_width, max_width, min_height, max_height, and (for image models) resolution_step — the value that width/height must be divisible by.
• Steps: min_steps, max_steps — how many inference steps the model supports.
• Video-specific: min_frames, max_frames, min_fps, max_fps.
• Text-specific: max_input_tokens, max_total_tokens (for embedding models), min_text, max_text (for speech models).

If you provide image dimensions that are not aligned to the required step, the API may adjust them automatically. To avoid unexpected output sizes, always round your width and height to a multiple of the model's resolution_step before sending the request.

Some models do not support guidance. Check info.features.supports_guidance — if it's false, do not send a guidance value, or set it to 0.

TIP

Always read info.limits and info.defaults from the models endpoint for the specific model you're using. Do not assume that limits from one model apply to another.

API usage examples

1. Discover models for your task

# Fetch all text-to-image models
curl -X GET "https://api.dryapi.dev/api/v1/client/models?filter[inference_types]=txt2img" \
  -H "Authorization: Bearer $DRYAPI_API_KEY" \
  -H "Accept: application/json"

# Read the response: pick a slug, note its limits and defaults.

2. Use the slug in a generation request

curl -X POST "https://api.dryapi.dev/api/v1/client/txt2img" \
  -H "Authorization: Bearer $DRYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "prompt": "isometric cozy cabin at dusk, soft rim light",
    "model": "<MODEL_SLUG>",
    "width": 768,
    "height": 768,
    "steps": 4,
    "seed": 12345
  }'

WARNING

Replace <MODEL_SLUG> with an actual slug value from the models endpoint. The seed field is required for image generation. Check info.limits for valid ranges of width, height, steps, and other parameters before sending.

3. Transcribe a video by URL

curl -X POST "https://api.dryapi.dev/api/v1/client/vid2txt" \
  -H "Authorization: Bearer $DRYAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "video_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
    "include_ts": true,
    "model": "<MODEL_SLUG>"
  }'

Jobs return a request_id. Poll results with GET /api/v1/client/request-status/{request_id}.

Best practices

• Resolve models during integration. Fetch the model list when building your integration and re-fetch periodically (e.g. daily or on deployment) to stay current. There's no need to call it on every request — the list doesn't change that often.
• Respect info.limits and info.defaults. Use the returned defaults as a starting point. Stay within min/max boundaries to avoid unexpected rounding or errors. Note that some required fields (like seed for image generation) may not be listed in the model response — refer to the task endpoint docs for the full set of required parameters.
• Pin slugs only when you need reproducibility. If you need consistent results across calls, keep the same slug and seed. But check the model list periodically — a slug may be retired and replaced.
• Budget before scaling. Larger models and higher resolution/steps cost more — see the Pricing page for per-task rates.
• Handle deprecation gracefully. If a model returns an error, re-fetch the model list and switch to a suitable alternative.

For AI agents & LLMs

If you are an AI agent, MCP client, or LLM integrating with dryAPI:

1. Call GET /api/v1/client/models at the start of your session to get the current model list. Do not rely on model slugs from training data, cached documentation, or prior conversations — they may be outdated.
2. Use filter[inference_types] to narrow down to the task you need (e.g. txt2img, txt2audio, aud2video).
3. Read info.limits and info.defaults from the response to construct valid request parameters. Also consult the task endpoint docs for required fields that may not appear in the model response (e.g. seed for image generation).
4. Pass the slug field (not name) as the model parameter in task endpoints.
5. If a model slug returns an error, re-fetch the model list — the model may have been deprecated or replaced.

Related docs

• Model Selection endpoint — the live API spec for fetching models.
• Pricing — cost per task and model tier.
• Execution Modes — sync, async, webhooks, WebSockets.