> ## Documentation Index
> Fetch the complete documentation index at: https://docs.threetone.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Groq

> Prepare a Groq chat model, protected API-key reference, and streaming connection probe without assuming runtime compatibility.

Groq offers a Chat Completions API at a documented compatibility endpoint. Prepare the candidate below and use Threetone's dashboard probe to check the specific model and credentials.

<Note>
  Connection testing is available, but custom-model publication and execution are unavailable. A successful probe is not a provider compatibility guarantee or a production release.
</Note>

## Candidate settings

| Threetone field | Candidate value |
| - | - |
| Server URL | `https://api.groq.com/openai/v1` |
| Model ID | The exact chat model ID currently enabled for your Groq account. |
| API Key | A workspace secret or Secret environment reference containing the Groq API key. |

Use the base URL from [Groq's compatibility documentation](https://console.groq.com/docs/openai). Keep `/chat/completions` out of Server URL. Groq documents differences in supported parameters; compatibility with a client library does not mean every request or model feature is interchangeable.

## Check the connection

<Steps>
  <Step title="Choose one chat model">
    Verify its current availability and limits in your provider account. Keep the exact model ID with your test record so a later model replacement is reviewed deliberately.
  </Step>

  <Step title="Configure the secret reference">
    In the agent's **Custom LLM** settings, enter the server URL and model ID, then select the API-key reference. Environment references use their production value during the probe. See [custom models](/agents-platform/advanced/custom-models/overview) for the complete field workflow.
  </Step>

  <Step title="Inspect the streaming result">
    Select **Test connection** only with approval to make a real provider request. The probe uses streaming Chat Completions with usage reporting requested and requires a nonempty assistant text delta. A model that only returns another response shape will fail this check.
  </Step>
</Steps>

Separate authentication errors, model-access errors, rate limits, and unsupported parameters when diagnosing failures. Do not add speculative headers or switch API types to bypass a failed probe; review [the accepted endpoint contract](/agents-platform/advanced/custom-models/compatible-endpoints).

Local edits are not a published version. If you need a durable candidate for review, save a complete server draft and read it back. Compare it with [managed model options](/overview/models) before planning a release.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="Do I need to install a Groq SDK in Threetone?" id="groq-faq-sdk">No SDK installation is part of this dashboard probe. You supply the endpoint, model identifier, and protected credential reference.</Accordion>
  <Accordion title="Does a successful text probe verify tool use or voice latency?" id="groq-faq-scope">No. It checks the probe's request and text stream. Tool behavior, conversation execution, speech, and end-to-end latency require separate supported runtime tests.</Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.