ModelsGRIKAI API

Developer API

Models

Discover AI Gateway model IDs, provider availability, RICO recipes, media workflows, and effect presets.

Model catalogs

Use /models for AI Gateway provider models and /rico/models for media recipes, workflows, and effects.

Example
curl https://api.grik.io/api/v1/models \
  -H "Authorization: Bearer GRIK_API_KEY"

# Model rows include api_type: responses, openai_compatible, or anthropic_messages.

curl "https://api.grik.io/api/v1/rico/models?type=recipe" \
  -H "Authorization: Bearer GRIK_API_KEY"
GET/models

List AI Gateway models with provider availability, context length, pricing, capabilities, and data policy metadata.

Auth: Optional bearerScope: -Audience: Developers
GET/rico/models

List RICO recipes, workflows, and effect presets. Optional type filters include recipe, workflow, and effect.

Auth: API keyScope: rico.media or videoAudience: Developers
GET/rico/models/:id

Inspect one RICO recipe, workflow, model, or effect preset by id.

Auth: API keyScope: rico.media or videoAudience: Developers
GET/rico/workflows

List media workflows available to RICO sessions and video automation.

Auth: API keyScope: rico.media or videoAudience: Developers
GET/rico/recipes

List reusable RICO recipes for generated media workflows.

Auth: API keyScope: rico.media or videoAudience: Developers

Routing and fallbacks

Chat completions accepts a primary model, fallback models, and provider routing hints.

Example
curl -X POST https://api.grik.io/api/v1/chat/completions \
  -H "Authorization: Bearer GRIK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "models": ["openai/gpt-4o-mini", "minimax/minimax-m3"],
    "provider": {
      "order": ["openrouter", "ricochet"],
      "ignore": ["experimental-provider"],
      "allow_fallbacks": true,
      "sort": "price"
    },
    "messages": [
      {"role": "user", "content": "Generate a release-risk checklist."}
    ]
  }'