1. Proprietary V1 image generation
Tokentone
  • Models
    • List models
      • Native OpenAI format
      • Native Gemini format
  • Images
    • Nano Banana
      • OpenAI chat format
    • Qwen format
      • Generate image
      • Edit image
    • Proprietary V1 image generation
      • Submit image generation task
        POST
      • Query image generation task
        GET
  • Chat
    • OpenAI endpoint
      • Responses format (next generation)
    • Anthropic endpoint
      • Native Claude format
  • Audio
    • Native OpenAI format
      • Audio transcription
      • Audio translation
      • Text-to-speech
    • iFlytek speech-to-text
      • URL audio async transcription
      • Asynchronous transcription via file stream
      • Query transcription result
    • Native Gemini format
      POST
  • Videos
    • Volcengine endpoint
      • Create a video generation task.
      • Query video generation task status and results.
      • Upload asset
      • Query asset details
    • Proprietary V1 video generation
      • Custom voice (TK)
        • Create Kling custom voice
        • Query custom voice task
      • Submit video generation task
      • Query video generation task
  • Embeddings
    • Native OpenAI format
      POST
    • Native Gemini format
      POST
  • Completions
    • Native OpenAI format
      POST
  • Realtime
    • Native OpenAI format
      GET
  • Rerank
    • Document reranking
      POST
  • Moderations
    • Native OpenAI format
      POST
  • Schemas
    • Schemas
      • User
      • Log
      • Token
      • PageInfo
      • Channel
      • Redemption
      • ApiResponse
      • ChatCompletionStreamResponse
      • ResponsesStreamResponse
      • ImageGenerationRequest
      • ImageEditRequest
      • AudioTranscriptionRequest
      • AudioTranslationRequest
      • VideoRequest
      • VideoResponse
      • VideoTaskResponse
      • VideoTaskMetadata
      • VideoTaskError
      • OpenAIVideo
      • OpenAIVideoError
    • Schemas
      • ApiResponse
      • PageInfo
      • User
      • Channel
      • Token
      • Redemption
      • Log
    • Model
    • key
    • ModelsResponse
    • CreateVideoTaskRequest
    • Message
    • ResponseEntityTencentTkCustomVoiceOrderResponse
    • MessageContent
    • OpenAiImageDataItem
    • Tool
    • ResponseEntityTencentTkCustomVoiceTaskQueryResponse
    • ToolCall
    • GeminiModelsResponse
    • ConfirmAigcEventsRequest
    • ChatCompletionResponse
    • AigcEventOutputFileDto
    • ChatCompletionRequest
    • ResponseEntity?
    • CompletionRequest
    • CompletionResponse
    • GptprotoMessageDto
    • ResponseFormat
    • TableDataInfo
    • ResponsesRequest
    • ResponsesResponse
    • ClaudeRequest
    • ClaudeMessage
    • ClaudeResponse
    • GeminiContentPartDto
    • EmbeddingRequest
    • ModelMap
    • EmbeddingResponse
    • VideoContentPart
    • ImageResponse
    • ChatInputAudioDto
    • AudioTranscriptionResponse
    • TencentTkCustomVoiceOrderRequest
    • SpeechRequest
    • OpenAiImageUsageTokenDetails
    • RerankRequest
    • AigcTaskDetailDto
    • RerankResponse
    • AigcEventItemDto
    • ModerationRequest
    • ModerationResponse
    • GeminiRequest
    • AjaxResult
    • GeminiResponse
    • ResponseEntityArkCreateContentsGenerationsTasksResponse
    • ResponseEntityTkVideoOrderResponse
    • IflyUrlProcessRequest
    • GeminiContentDto
    • ResponseEntityTkCustomVoiceOrderResponse
    • MediaUrl
    • ResponseEntityTkCustomVoiceTaskQueryResponse
    • ChatPartDto
    • ArkContentsGenerationsTaskError
    • OpenAiImageUsage
    • TkVideoFileInfo
    • GoogleGeminiPartDto
    • ResponseEntityTkVideoTaskQueryResponse
    • IflyAudioMeta
    • GptprotoImageGenerateRequest
    • TkCustomVoiceOrderRequest
    • ManageAiModelSaveRequest
    • ArkContentsGenerationsTaskContent
    • TkVideoSubjectInfo
    • IflyProperty
    • key
    • ArkContentsGenerationsTaskUsage
    • CreateVideoTaskResponse
    • ChatFunctionCallDto
    • ArkVideoTool
    • TencentTkVoiceRef
    • TkVoiceRef
    • ResponseEntityOpenAiImagesResponse
    • ResponseEntityArkGetContentsGenerationsTaskResponse
    • TkVideoOrderRequest
    • GoogleGeminiContentDto
    • IflyResultQueryRequest
    • OutputItem
    • ManageAiSupplierSaveRequest
    • ServerToolUse
    • IflyFileProcessRequest
    • Usage
    • ErrorResponse
    • GetVideoTaskResponse
    • ArkVideoContentPart
    • ChatToolCallDto
    • ArkCreateContentsGenerationsTasksRequest
    • GptprotoViduPredictionResponse
    • IflyPlatformSubmitResponse
    • OpenAiImageInputReference
    • GatewayErrorResponse
    • OpenAiImageGenerationRequest
    • MapString
    • CreateContentsGenerationsAssetRequest
    • GptprotoChatRequest
    • IflyPlatformQueryResponse
    • ManageWalletRechargeRequest
    • VolcengineGetAssetRequest
    • GoogleGeminiEmbedContentRequest
    • IflyTaskResultData
    • TencentTkVideoOutputConfigDto
    • TencentTkVideoSubjectInfo
    • AiVideoOrderResponse
    • AigcVideoTaskInputFileInfoDto
    • AigcVideoOutputConfigDto
    • AiVideoOrderRequest
    • GeminiUsageMetadataDto
    • GeminiCandidateDto
    • GeminiGenerateContentResponse
    • GeminiThinkingConfigDto
    • HttpStatusCode
    • CreateAigcImageResponse
    • AigcImageTaskInputFileInfoDto
    • AigcImageOutputConfigDto
    • CreateAigcImageRequest
    • TaskContent
    • CitationItem
    • ContentBlock
    • ClaudeWebSearchResponse
    • MessageItem
    • UserLocation
    • WebSearchToolItem
    • ClaudeWebSearchRequest
    • ChatMessageDto
    • CreateAigcApiTokenResponse
    • CreateAigcApiTokenRequest
    • ClaudeFileAnalysisResponse
    • CacheControl
    • DocumentSourceWrapper
    • CitationsConfig
    • ContentBlock
    • ClaudeFileAnalysisRequest
    • Container
    • ClaudeTextToTextResponse
    • ToolItem
    • ClaudeTextToTextRequest
    • ArkMediaUrl
    • PredictionData
    • GptprotoViduImageToVideoRequest
    • OpenAiImageEditRequest
    • GoogleGeminiInlineBlobDto
    • GoogleGeminiFileDataDto
    • GoogleGeminiGenerationConfigDto
    • GoogleGeminiGenerateContentRequest
    • DescribeTaskDetailResponse
    • DescribeTaskDetailRequest
    • PullAigcEventsResponse
    • GoogleGeminiFunctionCallDto
    • GoogleGeminiFunctionResponseDto
    • GoogleGeminiExecutableCodeDto
    • GoogleGeminiCodeExecutionResultDto
    • GoogleGeminiFunctionCallingConfigDto
    • GoogleGeminiLatLngDto
    • GoogleGeminiRetrievalConfigDto
    • GoogleGeminiToolConfigDto
    • GoogleGeminiThinkingConfigDto
    • GoogleGeminiSafetySettingDto
    • AiImageOrderResponse
    • AiImageOrderRequest
    • GptprotoChoiceDto
    • GptprotoUsageDto
    • GptprotoChatResponse
    • CacheControlEphemeral
    • JsonSchemaFormat
    • OutputConfig
    • ToolChoice
    • ImageDataItem
    • AiTextOrderResponse
    • GptprotoImageGenerateResponse
    • MapObject
    • MessageParam
    • AiTextOrderRequest
    • Metadata
    • ThinkingConfig
    • InputSchema
    • CitationsConfigParam
    • ToolDefinition
    • ManageAiModelPriceSaveRequest
    • AnthropicMessagesCreateRequest
    • CreateAigcVideoResponse
    • CreateAigcVideoRequest
    • ResponseEntityTencentTkVideoOrderResponse
    • TencentTkVideoFileInfo
    • TencentTkVideoOrderRequest
    • ResponseEntityTencentTkVideoTaskQueryResponse
    • GeminiGenerationConfigDto
    • TaskUsage
    • ManageAiModelVendorSaveRequest
    • GeminiGenerateContentRequest
    • TaskError
    • GoogleGeminiSystemInstructionDto
    • ContentBlockParam
    • ManageAiCustomerTokenSaveRequest
    • CreateAssetRequest
    • key
    • StringOrContentBlocks
    • ManageAiModelSupplierRouteSaveRequest
    • IflyAsrcSegment
    • key
    • key
    • ResponseEntityStreamingResponseBody
    • TextCitationParam
    • TextBlockParam
    • key
    • StringOrTextBlocks
    • ResponseEntityTencentTkImageOrderResponse
    • GoogleGeminiCodeExecutionToolDto
    • TencentTkImageFileInfo
    • MapJsonNode
    • TencentTkImageOrderRequest
    • GoogleGeminiToolDto
    • ResponseEntityTencentTkImageTaskQueryResponse
    • VolcengineMediaUrl
    • VolcengineVideoContentPart
    • VolcengineVideoTool
    • VolcengineCreateVideoTaskRequest
    • ConversationModelOption
    • ConversationSessionItem
    • ConversationMessageItem
    • ConversationSendRequest
    • Handler
    • MediaType
    • DataWithMediaType
    • Throwable
    • StackTraceElement
    • Runnable
    • DefaultCallback
    • ErrorCallback
    • SseEmitter
    • ConversationImageOrderRequest
    • ConversationVideoOrderRequest
    • CitationItem
    • Usage
    • MessageItem
    • key
    • key
    • CitationItem
    • ContentBlock
    • Usage
    • ContentBlock
    • MessageItem
    • GoogleGeminiGenerateContentPayloadDto
    • GoogleGeminiCountTokensRequest
    • GoogleGeminiCreateCachedContentRequest
    • GoogleGeminiPatchCachedContentRequest
    • AccountAiCustomerTokenCreateRequest
    • ResponseEntityMapObject
  1. Proprietary V1 image generation

Submit image generation task

POST
/tk/v1/images/generations
Submit image generation task
Supported models:
gemini-2.5-flash-image-v1
gemini-3-pro-image-preview-v1
gemini-3.1-flash-image-preview-v1
doubao-seedream-4-0-250828-v1
doubao-seedream-4-5-251128-v1
Resolution support:
gemini-2.5-flash-image-v1: 1K, 2K, 4K; default 1K;
gemini-3-pro-image-preview-v1: 1K, 2K, 4K; default 1K;
gemini-3.1-flash-image-preview-v1: 512, 1K, 2K, 4K; default 1K;
doubao-seedream-4-0-250828-v1: 1K, 2K, 4K; default 1K;
doubao-seedream-4-5-251128-v1: 2K, 4K; default 2K;
Aspect ratio:
gemini-2.5-flash-image-v1: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9;
gemini-3-pro-image-preview-v1: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9;
gemini-3.1-flash-image-preview-v1: 1:1, 1:4, 1:8, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9, 21:9;
doubao-seedream-4-0-250828-v1: this parameter is not supported; specify 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 via prompt;
doubao-seedream-4-5-251128-v1: this parameter is not supported; specify 16:9, 9:16, 1:1, 4:3, 3:4, 3:2, 2:3, 21:9 via prompt;
Maximum input image count:
gemini-2.5-flash-image-v1: 3 images;
gemini-3-pro-image-preview-v1: 14 images;
gemini-3.1-flash-image-preview-v1: 14 images;
doubao-seedream-4-0-250828-v1: 14 images;
doubao-seedream-4-5-251128-v1 4.5: 14 images;

Request

Header Params

Body Params application/jsonRequired

Example
{
    "model": "gemini-3-pro-image-preview-c",
    "fileInfos": null,
    "prompt": "Generate a cat-and-dog battle image",
    "seed": null,
    "resolution": "1K",
    "aspectRatio": "16:9"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/tk/v1/images/generations' \
--header 'Authorization: Bearer sk-***' \
--header 'Content-Type: application/json' \
--data '{
    "model": "gemini-3-pro-image-preview-c",
    "fileInfos": null,
    "prompt": "Generate a cat-and-dog battle image",
    "seed": null,
    "resolution": "1K",
    "aspectRatio": "16:9"
}'

Responses

🟢200
application/json
Bodyapplication/json

Example
{
    "taskId": "",
    "requestId": ""
}
Modified at 2026-07-15 15:01:15
Previous
Edit image
Next
Query image generation task
Built with