Skip to content
agentgateway has joined the Agentic AI Foundation — Learn more

For the complete documentation index, see llms.txt. Markdown versions of all docs pages are available by appending .md to any docs URL.

Meta

Page as Markdown

Route agentgateway LLM traffic to the Meta Model API.

Configure Meta as an LLM provider in agentgateway. The meta preset supports the Chat Completions, Messages, and Responses APIs.

Before you begin

Install the agentgateway binary.

You need agentgateway 1.6.0 or later and a Meta Model API key. Create a key in the Meta Model API dashboard.

Configuration

Use the meta preset to route requests to the Meta Model API. The preset supplies the provider URL and supported request formats.

  1. Set your API key in the terminal where you will run agentgateway.

    export META_API_KEY='<your-api-key>'
  2. Create a config.yaml file with the following configuration.

    cat > config.yaml <<'EOF'
    # yaml-language-server: $schema=https://agentgateway.dev/schema/config
    llm:
      models:
      - name: "*"
        provider: meta
        params:
          apiKey: "$META_API_KEY"
          # Optional: use this upstream model for every matching request.
          # model: muse-spark-1.3
          # Optional: override the default provider URL.
          # baseUrl: https://api.meta.ai/v1
    EOF
    SettingDescription
    nameThe model name to match in incoming requests. Use * to accept any model name.
    providerThe provider preset. Set to meta.
    params.apiKeyYour Meta Model API key. Use $META_API_KEY to read the key from the environment.
    params.modelOptional. The upstream model to use for every matching request. Omit to use the model from the request.
    params.baseUrlOptional. Overrides the provider URL. Defaults to https://api.meta.ai/v1.
  3. Validate the configuration.

    agentgateway -f config.yaml --validate-only

    Example output:

    Configuration is valid!
  4. Start agentgateway.

    agentgateway -f config.yaml

Example request

From another terminal, send a Chat Completions request to the gateway. This example uses muse-spark-1.3, as shown in the Meta quickstart. Use a model that your Meta account can access.

curl http://localhost:4000/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "muse-spark-1.3",
    "messages": [{"role": "user", "content": "Hello from Meta!"}]
  }'
Was this page helpful?
Agentgateway assistant

Ask me anything about agentgateway configuration, features, or usage.

Note: AI-generated content might contain errors; please verify and test all returned information.

Tip: one topic per conversation gives the best results. Use the + button in the chat header to start a new conversation.

Switching topics? Starting a new conversation improves accuracy.
↑↓ navigate ↵ select esc dismiss

What could be improved?

Your feedback helps us improve assistant answers and identify docs gaps we should fix.

Need more help? Join us on Discord: https://discord.gg/y9efgEmppm

Want to use your own agent? Add the Solo MCP server to query our docs directly. Get started here: https://search.solo.io/.