메인 콘텐츠로 건너뛰기
POST
/
v1beta
/
models
/
gemini-3.1-pro-preview:
{method}
curl --request POST \ --url https://api.evolink.ai:{method}/v1beta/models/gemini-3.1-pro-preview:62437 \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "contents": [ { "role": "user", "parts": [ { "text": "Please introduce yourself" } ] } ] } '
{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "Hello! I'm pleased to introduce myself.\n\nI'm a large language model, trained and developed by Google..."
          }
        ]
      },
      "finishReason": "STOP",
      "index": 0,
      "safetyRatings": [
        {}
      ]
    }
  ],
  "promptFeedback": {
    "safetyRatings": [
      {}
    ]
  },
  "usageMetadata": {
    "promptTokenCount": 4,
    "candidatesTokenCount": 611,
    "totalTokenCount": 2422,
    "thoughtsTokenCount": 1807,
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 4
      }
    ]
  }
}

인증

​
Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

경로 매개변수

​
method
enum<string>
필수

생성 방식:

  • generateContent: 완전한 응답을 한 번에 반환
  • streamGenerateContent: 스트리밍 생성, 콘텐츠를 실시간 청크로 반환
사용 가능한 옵션:
generateContent,
streamGenerateContent

본문

application/json
​
contents
object[]
필수

대화 내용 목록, 다중 턴 대화 및 멀티모달 입력 지원

Minimum array length: 1
​
generationConfig
object

생성 설정 파라미터 (선택 사항)

응답

콘텐츠가 성공적으로 생성되었습니다

응답 형식 설명:

  • method=generateContent이고 비동기 모드가 아닐 때, GenerateContentResponse 반환 (완전한 응답을 한 번에 반환)
  • method=streamGenerateContent이고 비동기 모드가 아닐 때, StreamGenerateContentResponse 반환 (스트리밍 응답, 콘텐츠를 청크 단위로 반환)
​
candidates
object[]

마지막 프레임 이미지 URL

참고:

  • image_start (첫 프레임 이미지 URL)와 image_end (마지막 프레임 이미지 URL) 중 하나 이상 필요
  • 마지막 프레임은 첫 프레임이 필요합니다
  • 이미지 요구사항은 image_start와 동일합니다
​
promptFeedback
object
​
usageMetadata
object

사용량 통계