# Integrate with apps

Use the Genesis console's **Usage Guide** page to view connection details and generate request templates. This page explains preparation and copying in the console. Use the corresponding developer API page for authentication headers, request parameters, and response fields.

## Before integrating

Prepare the following information:

1. Open a model in the [model marketplace](models.md#view-model-details) and copy its model ID.
2. Create a personal access token or a service-account API key with Genesis permission. See [Manage Genesis access credentials](api-keys.md#choose-a-credential-type).
3. Read [Prepare to call an API](../../developer/api/api-call-basics.md) and confirm the credential and authentication headers for the selected endpoint.

## Copy a template from the Usage Guide

1. Open **Usage Guide** in the left navigation.
2. Copy the Base URL from **Connection information**.
3. In **API usage**, select the endpoint and example language.
4. Switch between **Input example**, **Response example**, and **Parameter descriptions** to check the model and business input for that endpoint.
5. Copy the generated template, replace its credential, model ID, and business input, and run it locally.

![Genesis Usage Guide with connection details, endpoint and language selection, and API usage examples.](../../../zh/guides/genesis/images/api-usage.png)

Templates provide a starting point. For complete API definitions, see [Genesis API](../../developer/api/genesis/index.md). Text chat, multimodal chat, embeddings, rerank, and Responses have separate developer pages. For Messages, also check authentication and request requirements on its API page.

## Check the model and response in a template

Before running a template, [list callable models](../../reference/api/genesis/models.md#successful-response) and confirm that its model ID is in the current credential's results. Replace the template's model value with the selected ID. The catalog can change; check fixed names and placeholders against the current results.

- For [Messages](../../reference/api/genesis/text-generation/anthropic-messages.md#before-you-begin), choose a model whose capabilities include **messages**.
- For [Rerank](../../reference/api/genesis/text-reranking/rerank.md#before-you-begin), choose a rerank model that supports the target input type. Image or other multimodal inputs also require the corresponding capabilities.

A **response example** illustrates the response structure. Determine success from the actual local request's status, response content, and business result. Copying a template or seeing reply text in a sample does not confirm that a model call has completed.

## What to check first when integration fails

| Symptom | Check first |
| --- | --- |
| 401 or authentication failure | Check the credential type, token status, and headers in [Prepare to call an API](../../developer/api/api-call-basics.md). |
| Model unavailable | Check that the request's model ID matches the [model marketplace](models.md), and [list models](../../reference/api/genesis/models.md) to confirm access for the current credential. |
| Unsupported endpoint or parameters | Confirm that the model supports the selected endpoint. Validate it in [Debug](debug.md), then check the corresponding developer API page. |
| Need to locate a call | Open **Logs** under [Monitor operations](observe.md) and use the available filters to find the record. |