> ## Documentation Index
> Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Gemini 3.0 Pro - Native API - Quick Start
> - Use Google Native API format to call Gemini-3.0-pro model
- Synchronous processing mode, real-time response
- Minimal parameters for quick start
- 💡 Need more features? Check [Full API Reference](./native-api-reference)
**Streaming**: Replace `generateContent` with `streamGenerateContent` in the URL to enable streaming responses, receiving content in real-time chunks.
**BaseURL**: The default BaseURL is `https://direct.evolink.ai`, which has better support for text models and long-lived connections. `https://api.evolink.ai` is the primary endpoint for multimodal services and serves as a fallback address for text models.
## OpenAPI
````yaml /en/api-manual/language-series/gemini-3.0-pro/native-api/native-api-quickstart.json POST /v1beta/models/gemini-3-pro-preview:generateContent
openapi: 3.1.0
info:
title: Gemini Native API - Quick Start
description: >-
Get started with Google Gemini Native API, complete your first AI
conversation in 5 minutes
license:
name: MIT
version: 1.0.0
servers:
- url: https://direct.evolink.ai
description: Production (recommended)
- url: https://api.evolink.ai
description: Alternative URL
security:
- bearerAuth: []
tags:
- name: Content Generation
description: Gemini AI content generation APIs
paths:
/v1beta/models/gemini-3-pro-preview:generateContent:
post:
tags:
- Content Generation
summary: Gemini-3.0-pro Quick Chat
description: >-
- Use Google Native API format to call Gemini-3.0-pro model
- Synchronous processing mode, real-time response
- Minimal parameters for quick start
- 💡 Need more features? Check [Full API
Reference](./native-api-reference)
operationId: generateContentQuick
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateContentQuickRequest'
responses:
'200':
description: Content generated successfully
content:
application/json:
schema:
$ref: '#/components/schemas/GenerateContentResponse'
'400':
description: Invalid request parameters
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 400
message: Invalid request parameters
type: invalid_request_error
'401':
description: Unauthenticated, invalid or expired token
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 401
message: Invalid or expired token
type: authentication_error
'402':
description: Insufficient quota, recharge required
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 402
message: Insufficient quota
type: insufficient_quota_error
fallback_suggestion: https://evolink.ai/dashboard/billing
'403':
description: Access denied
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 403
message: Access denied for this model
type: permission_error
'404':
description: Resource not found
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 404
message: Model not found
type: not_found_error
'429':
description: Rate limit exceeded
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 429
message: Rate limit exceeded
type: rate_limit_error
fallback_suggestion: retry after 60 seconds
'500':
description: Internal server error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 500
message: Internal server error
type: internal_server_error
fallback_suggestion: try again later
'502':
description: Upstream service error
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 502
message: Upstream AI service unavailable
type: upstream_error
fallback_suggestion: try again later
'503':
description: Service temporarily unavailable
content:
application/json:
schema:
$ref: '#/components/schemas/ErrorResponse'
example:
error:
code: 503
message: Service temporarily unavailable
type: service_unavailable_error
fallback_suggestion: retry after 30 seconds
components:
schemas:
GenerateContentQuickRequest:
type: object
required:
- contents
properties:
contents:
type: array
description: Conversation content list
items:
$ref: '#/components/schemas/ContentSimple'
minItems: 1
example:
- role: user
parts:
- text: Hello, please introduce yourself
GenerateContentResponse:
type: object
properties:
candidates:
type: array
description: List of candidate responses
items:
$ref: '#/components/schemas/Candidate'
promptFeedback:
$ref: '#/components/schemas/PromptFeedback'
usageMetadata:
$ref: '#/components/schemas/UsageMetadata'
ErrorResponse:
type: object
properties:
error:
type: object
properties:
code:
type: integer
description: HTTP status error code
message:
type: string
description: Error description
type:
type: string
description: Error type
fallback_suggestion:
type: string
description: Fallback suggestion on error
ContentSimple:
type: object
required:
- role
- parts
properties:
role:
type: string
description: Content role
enum:
- user
example: user
parts:
type: array
description: Content parts list (plain text)
items:
$ref: '#/components/schemas/TextPart'
minItems: 1
Candidate:
type: object
properties:
content:
$ref: '#/components/schemas/ContentResponse'
finishReason:
type: string
description: Finish reason
enum:
- STOP
- MAX_TOKENS
- SAFETY
- RECITATION
- OTHER
example: STOP
index:
type: integer
description: Candidate index
example: 0
safetyRatings:
type: array
nullable: true
description: Safety ratings
items:
type: object
PromptFeedback:
type: object
properties:
safetyRatings:
type: array
nullable: true
description: Prompt safety ratings
items:
type: object
UsageMetadata:
type: object
description: Usage statistics
properties:
promptTokenCount:
type: integer
description: Number of tokens in input
example: 4
candidatesTokenCount:
type: integer
description: Number of tokens in output
example: 611
totalTokenCount:
type: integer
description: Total number of tokens
example: 2422
thoughtsTokenCount:
type: integer
description: Number of reasoning tokens
example: 1807
promptTokensDetails:
type: array
description: Detailed input token information (by modality)
items:
$ref: '#/components/schemas/TokenDetail'
TextPart:
type: object
required:
- text
properties:
text:
type: string
description: Text content
example: |-
Hello! I'm glad to introduce myself.
I'm a large language model trained and developed by Google...
ContentResponse:
type: object
properties:
role:
type: string
description: Response role
enum:
- model
example: model
parts:
type: array
description: Response content parts
items:
$ref: '#/components/schemas/TextPart'
TokenDetail:
type: object
description: Token details (by modality)
properties:
modality:
type: string
description: Content modality type
enum:
- TEXT
- IMAGE
- AUDIO
- VIDEO
example: TEXT
tokenCount:
type: integer
description: Number of tokens for this modality
example: 4
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
##All APIs require Bearer Token authentication##
**Get API Key:**
Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to
get your API Key
**Add to request header:**
```
Authorization: Bearer YOUR_API_KEY
```
````