<meta charset="utf-8" /><meta http-equiv="content-security-policy" content=""><meta name="hf:doc:metadata" content="{&quot;local&quot;:&quot;more-information-about-the-api&quot;,&quot;sections&quot;:[{&quot;local&quot;:&quot;rate-limits&quot;,&quot;title&quot;:&quot;Rate limits&quot;},{&quot;local&quot;:&quot;running-private-models&quot;,&quot;title&quot;:&quot;Running private models&quot;},{&quot;local&quot;:&quot;running-a-public-model-that-i-do-not-own&quot;,&quot;title&quot;:&quot;Running a public model that I do not own&quot;},{&quot;local&quot;:&quot;finetuning-a-public-model&quot;,&quot;title&quot;:&quot;Finetuning a public model&quot;},{&quot;local&quot;:&quot;tracking-metrics&quot;,&quot;title&quot;:&quot;Tracking metrics&quot;},{&quot;local&quot;:&quot;running-the-inference-on-my-infrastructure&quot;,&quot;title&quot;:&quot;Running the inference on my infrastructure&quot;}],&quot;title&quot;:&quot;More information about the API&quot;}" data-svelte="svelte-1phssyn">
	<link rel="stylesheet" href="/docs/api-inference/pr_803/en/_app/assets/pages/__layout.svelte-ab71f83a.css">
	<link rel="modulepreload" href="/docs/api-inference/pr_803/en/_app/start-9f0d6b1d.js">
	<link rel="modulepreload" href="/docs/api-inference/pr_803/en/_app/chunks/vendor-7c454903.js">
	<link rel="modulepreload" href="/docs/api-inference/pr_803/en/_app/chunks/paths-4b3c6e7e.js">
	<link rel="modulepreload" href="/docs/api-inference/pr_803/en/_app/pages/__layout.svelte-6835d907.js">
	<link rel="modulepreload" href="/docs/api-inference/pr_803/en/_app/pages/faq.mdx-5a5733df.js">
	<link rel="modulepreload" href="/docs/api-inference/pr_803/en/_app/chunks/IconCopyLink-5457534b.js"> 





<h1 class="relative group"><a id="more-information-about-the-api" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#more-information-about-the-api"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a>
	<span>More information about the API
	</span></h1>

<h2 class="relative group"><a id="rate-limits" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#rate-limits"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a>
	<span>Rate limits
	</span></h2>

<p>The current API does not enforce strict rate limitations. Instead we
simply balance the loads evenly between all our available ressources,
and favoring steady flows of requests. If your account suddenly sends
10k requests then you’re likely to receive 503 errors saying models are
loading up. In order to prevent that, you should instead try to start
running queries smoothly from 0 to 10k over the course of a few minutes.</p>
<h2 class="relative group"><a id="running-private-models" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#running-private-models"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a>
	<span>Running private models
	</span></h2>

<p>You can run private models by default ! If you don’t see them on you
<a href="https://huggingface.co" rel="nofollow">Hugging Face</a> page please make sure you are
logged in. Within the API make sure you include your token, otherwise
your model will be declared as non existent.</p>
<h2 class="relative group"><a id="running-a-public-model-that-i-do-not-own" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#running-a-public-model-that-i-do-not-own"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a>
	<span>Running a public model that I do not own
	</span></h2>

<p>You can. Please check the model card for any licensing issue that might
arise, but most public models are delivered by researchers and are
usable within commercial products. But please double check.</p>
<h2 class="relative group"><a id="finetuning-a-public-model" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#finetuning-a-public-model"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a>
	<span>Finetuning a public model
	</span></h2>

<p>We currently don’t provide finetuning automatically for any model on
your data, but we announced a product in that sense:
<a href="https://twitter.com/huggingface/status/1341435640458702849" rel="nofollow">https://twitter.com/huggingface/status/1341435640458702849</a></p>
<h2 class="relative group"><a id="tracking-metrics" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#tracking-metrics"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a>
	<span>Tracking metrics
	</span></h2>

<p>This is an area of active improvement. Stay tuned as we release more
features to track your API usage!</p>
<h2 class="relative group"><a id="running-the-inference-on-my-infrastructure" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#running-the-inference-on-my-infrastructure"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a>
	<span>Running the inference on my infrastructure
	</span></h2>

<p>Currently we do not provide <strong>on premises</strong> inference out of the box. If
you want to get our Accelerated Inference on your infrastructure you
need to contact us at <a href="mailto:api-enterprise@huggingface.co">api-enterprise@huggingface.co</a></p>


		<script type="module" data-hydrate="xh99l7">
		import { start } from "/docs/api-inference/pr_803/en/_app/start-9f0d6b1d.js";
		start({
			target: document.querySelector('[data-hydrate="xh99l7"]').parentNode,
			paths: {"base":"/docs/api-inference/pr_803/en","assets":"/docs/api-inference/pr_803/en"},
			session: {},
			route: false,
			spa: false,
			trailing_slash: "never",
			hydrate: {
				status: 200,
				error: null,
				nodes: [
					import("/docs/api-inference/pr_803/en/_app/pages/__layout.svelte-6835d907.js"),
						import("/docs/api-inference/pr_803/en/_app/pages/faq.mdx-5a5733df.js")
				],
				params: {}
			}
		});
	</script>
