HuggingFace (gateway)

Route HuggingFace Inference API calls through the Respan gateway to use 250+ models from different providers. Only your RESPAN_API_KEY is needed.

Setup

Install packages

$ pip install respan-ai opentelemetry-instrumentation-transformers transformers

Set environment variables

$ export RESPAN_API_KEY="YOUR_RESPAN_API_KEY"

Point an OpenAI-compatible client to the Respan gateway

1 import os
2 from openai import OpenAI
3 
4 client = OpenAI(
5     api_key=os.environ["RESPAN_API_KEY"],
6     base_url="https://api.respan.ai/api",
7 )
8 
9 response = client.chat.completions.create(
10     model="huggingface/meta-llama/Llama-3-8B-Instruct",
11     messages=[{"role": "user", "content": "Say hello in three languages."}],
12 )
13 print(response.choices[0].message.content)

Switch models

Change the model parameter to use 250+ models from different providers through the same gateway.

1 response = client.chat.completions.create(model="huggingface/meta-llama/Llama-3-8B-Instruct", messages=messages)
2 response = client.chat.completions.create(model="gpt-4.1-nano", messages=messages)

See the full model list.

1	import os
2	from openai import OpenAI
3
4	client = OpenAI(
5	api_key=os.environ["RESPAN_API_KEY"],
6	base_url="https://api.respan.ai/api",
7	)
8
9	response = client.chat.completions.create(
10	model="huggingface/meta-llama/Llama-3-8B-Instruct",
11	messages=[{"role": "user", "content": "Say hello in three languages."}],
12	)
13	print(response.choices[0].message.content)