GET /v1/models for the catalog available to your key.
July 13, 2026
Documentation baseline
- Added complete Claude Code and Codex CLI setup guides for macOS, native Windows, and WSL 2, plus practical coding-agent examples.
- Published the complete Mintlify documentation for Models, Chat Completions, Responses, Images, Embeddings, and Audio Transcriptions.
- Added production guides for streaming, vision, function calling, structured output, image generation, and reliability practices.
- Added OpenAI-compatible SDK setup for Python, JavaScript, and Go.
- Added end-to-end examples in curl, JavaScript Fetch, and Python.
- Documented configurable rate limits and the OpenAI-compatible error envelope.
Compatibility policy
Yelu follows OpenAI-compatible endpoint and field conventions while routing to multiple providers. Compatibility has three practical boundaries:- Gateway contract — authentication, paths, common request fields, error envelope, and normalized response shapes documented here.
- Model capability — support for vision, tools, JSON output, reasoning, modalities, and specific limits depends on the selected model and upstream provider.
- Account catalog — enabled models and commercial terms depend on your account and are discoverable through the dashboard and Models API.
Integrations should ignore unknown response fields, tolerate additive changes, and avoid depending on provider-specific behavior unless it is tested for the selected model.
Stay compatible
- Discover models instead of maintaining a permanent local list.
- Pin SDK major versions and review their release notes before upgrades.
- Validate structured outputs in your application even when a model supports JSON schema.
- Add contract tests for critical prompts, tool schemas, and streaming parsers.
- Subscribe to operational announcements available through your Yelu account.