synthetic
    /Dev
    • Back to app
    Usage-based pricing
    • Usage & Billing
    API Documentation
    API
    • Overview
    • Getting Started
    • Models
    OpenAI Reference
    • /models
    • /chat/completions
    • /completions
    • /embeddings
    Anthropic Reference
    • /messages
    • /messages/count_tokens
    Synthetic Reference
    • /quotas
    Guides
    • Claude Code
    • Octofriend by Synthetic
    • GitHub Copilot
    • Xcode Intelligence

    Models

    GET https://staging-api.synthetic.new/openai/v1/models

    List and retrieve information about available models.

    Tip

    /models requests do not count against your subscription limits!

    Tip

    The /models endpoint will always show all always-on models, as well as any on-demand models you've recently used.

    Example Request

    • Python
    • TypeScript
    • curl
    import openai
    
    client = openai.OpenAI(
      api_key="SYNTHETIC_API_KEY",
      base_url="https://staging-api.synthetic.new/openai/v1"
    )
    
    # List all available models
    models = client.models.list()
    print(models)

    Example Response

    • json
    {
      "data": [
        {
          "id": "hf:deepseek-ai/DeepSeek-V3.1",
          "object": "model"
        },
        {
          "id": "hf:Qwen/Qwen3-235B-A22B-Instruct-2507",
          "object": "model"
        },
        {
          "id": "hf:zai-org/GLM-4.6",
          "object": "model"
        },
        {
          "id": "hf:openai/gpt-oss-120b",
          "object": "model"
        },
        {
          "id": "hf:moonshotai/Kimi-K2-Instruct",
          "object": "model"
        },
      ]
    }
    

    Model Naming Convention

    All model IDs follow the pattern: hf:{owner}/{model-name}

    • hf: - Required prefix indicating a Hugging Face model
    • owner - The organization or user who published the model
    • model-name - The specific model name and version