Skip to content

docs: OpenAI/OpenRouter base URL must include /v1; skip embeddings on chat-only hosts #1655

Description

@cursor

The OpenRouter / OpenAI interface path already works for hosted Chat Completions hosts. Two details are easy to get wrong when the host is not OpenAI or DeepSeek:

  1. API Base URL must be the /v1 root. The DeepSeek screenshot uses https://api.deepseek.com (origin only). A Chat Completions-first host that mounts at /v1 404s without that suffix. Do not append /chat/completions.
  2. Do not point the embedding model at a chat-only host. POST /v1/embeddings is not a Chat Completions surface. Leave embeddings on a host that actually serves them.

PZERO is a live OpenAI-compatible host. Catalog: GET https://api.pzero.studio/v1/models. Default text id: deepseek-v4-flash. Prepaid Bearer key (pzero_…). Needs langchain-openai. Use OpenRouter * or the OpenAI provider; local model ID is the catalog id (no openai/ prefix).

Settings:

  • Provider: OpenRouter * or OpenAI
  • Local model ID: deepseek-v4-flash
  • API Base URL: https://api.pzero.studio/v1
  • API key: pzero_…
  • Embedding model: leave unset / not this host

Distinct from #1171 (that request added OpenRouter / OpenAI base_url support). This is the remaining /v1 vs origin and embeddings gotcha.

No first-party provider asked. If a named vendor subsection is too much, the two gotchas above are the docs gap.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions