← Learn

OpenAI-compatible API

An HTTP API that mirrors OpenAI’s chat/completions shapes so existing SDKs and agents can swap providers without rewriting client code.

Learn

When to use it

Use an OpenAI-compatible API when you need to switch from OpenAI’s services to another provider without rewriting your application’s client-side code. OpenAI-compatible APIs let you swap providers while maintaining existing SDKs and agent workflows, enabling seamless transitions for tasks like text generation and chat interactions.

Quick example

In a project using OpenAI’s GPT-4 for generating customer support responses, you might need to switch to a different provider due to cost or performance considerations. By using an OpenAI-compatible API like Hetzner's, you can make this switch without changing your existing codebase, as the API mirrors the same HTTP request and response structures. Here, Hetzner's API acts as the OpenAI-compatible API, allowing for a quick provider swap.

prompt → OpenAI-compatible API → response

Ecosystem

OpenAI-compatible APIs fit into the broader landscape of AI service providers, allowing for flexible integration with existing AI models and tools.

prompt → OpenAI-compatible API → model → response

Misconceptions

MisconceptionRebuttal
It's a new AI modelIt's an API interface, not a model itself
Only OpenAI can use itAny provider can implement this API structure
It requires rewriting codeIt mirrors existing API shapes to avoid rewrites

Trade-offs

  • Provider flexibility — limited to providers offering compatible APIs
  • Seamless integration — potential for minor discrepancies in API behavior
  • Cost savings — may involve initial setup or testing time

Seen in