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

# SDK and protocol compatibility

> See which REST routes and authentication method are supported, and why Google Gen AI SDK and OpenAI SDK compatibility are not currently promised.

The supported integration surface is the Gemini-style REST subset documented by this site's [OpenAPI](/openapi.json). Use ordinary HTTP clients with the API base URL and Bearer authentication:

```text theme={"system"}
Base URL: https://api.yingtu.ai
Authorization: Bearer YOUR_YINGTU_API_KEY
```

## Supported client methods

| Client method                            | Support status                               |
| ---------------------------------------- | -------------------------------------------- |
| cURL or another HTTP client              | Supported                                    |
| Python `requests` or equivalent          | Supported                                    |
| JavaScript `fetch` or equivalent         | Supported                                    |
| Google Gen AI SDK with a custom base URL | Not in the current supported contract        |
| OpenAI SDK                               | Not supported for these Gemini-native routes |

The [Quickstart](/en/getting-started/quickstart) contains complete cURL, Python, and Node.js examples. A library may be able to send a custom HTTP request, but that does not make its authentication, path construction, retries, response types, or future versions an officially supported SDK integration.

## Supported REST operations

| Task                              | Operation                                          |
| --------------------------------- | -------------------------------------------------- |
| Synchronous generation or editing | `POST /v1beta/models/{model}:generateContent`      |
| Asynchronous submission           | `POST /v1beta/models/{model}:asyncGenerateContent` |
| Task retrieval                    | `GET /v1/tasks/{task_id}`                          |

All three operations use the same Bearer credential convention. Copy an exact current model ID from the [model marketplace](https://api.yingtu.ai/pricing) or [model ID reference](/en/resources/model-ids).

## Compatibility means an implemented subset

The request resembles Google's GenerateContent structure, but the public contract is not a promise of complete compatibility with every current or future Gemini field, tool, file workflow, authentication mode, streaming method, or SDK feature.

A capability is supported only when it appears in the current OpenAPI and the relevant model Parameters page. The model-fixed Playground is also narrower than the generic protocol reference; a successful Try it request does not certify an SDK.

If a specific SDK is required for production, send its name, version, language, authentication requirement, and required operations to [API support](/en/resources/technical-support). Until a versioned compatibility matrix is published, use the REST examples as the maintained integration path.

<CardGroup cols={2}>
  <Card title="Run the REST Quickstart" icon="rocket" href="/en/getting-started/quickstart">
    Generate and parse an image with cURL, Python, or Node.js.
  </Card>

  <Card title="Inspect the OpenAPI" icon="braces" href="/en/api-reference/generate-content">
    Review the exact request, response, and error contract.
  </Card>
</CardGroup>