302.AI API Document
  1. Doubao
  • Large Language Model
    • API Migration Guide
    • Exclusive Feature
      • Search Online
        • Chat(Search online)
      • Depth-First Search
        • Chat(Depth-First Search)
      • Image Analysis
        • Chat(Image analysis)
      • Reasoning mode
        • Chat(Reasoning mode)
      • Link Parsing
        • Chat(Link Parsing)
      • Tool Invocation
        • Chat(tool invocation)
      • Long-term memory (Beta)
        • Memobase
          • User Management
            • Create User
            • Get User
            • Update User
            • Delete User
          • Data Management
            • Insert Data
            • Get Datas
            • Get Data
            • Delete Data
          • Memory Management
            • Flush Buffer (Generate Memory)
            • Get User Profile (Get Memory)
            • Delete User Profile (Delete Memory)
        • Chat (Long-term Memory)
      • Simplified API
        • Chat (Simplified API)
    • Model Support
      • Models (List models)
      • Status(Model Status)
    • OpenAI
      • Chat(Talk)
      • Chat(Streamed return.)
      • Chat (gpt-4o Image Analysis)
      • Chat (gpt-4o Structured Output)
      • Chat (gpt-4o function call)
      • Chat (gpt-4-plus image analysis)
      • Chat (gpt-4-plus image generation)
      • Chat(gpt-4o-image-generation modify image)
      • Chat (gpts model)
      • Chat (chatgpt-4o-latest)
      • Chat (o1 Series Model)
      • Chat (o3 Series Model)
      • Chat(o4 Series)
      • Chat(gpt-4o audio model)
    • Anthropic
      • Chat(Talk)
      • Chat(Analyze image)
      • Chat(Function Call)
      • Messages(Original format)
      • Messages(Function Call)
      • Messages(Thinking mode)
      • Messages(128k output)
    • Gemini
      • Chat(Talk)
      • Chat(Analyze image)
      • Chat(Image Generation)
    • China Model
      • Chat (Baidu ERNIE)
      • Chat (Tongyi Qianwen)
      • Chat (Tongyi Qianwen-VL)
      • Chat(Tongyi Qianwen-OCR)
      • Chat (Zhipu GLM-4)
      • Chat (Zhipu GLM-4V)
      • Chat (Baichuan AI)
      • Chat (Moonshot AI)
      • Chat (Moonshot AI-Vision)
      • Chat (01.AI)
      • Chat (01.AI-VL)
      • Chat (DeepSeek)
      • Chat (DeepSeek-VL2)
      • Chat (ByteDance Doubao)
      • Chat (ByteDance Doubao-Vision)
      • Chat(ByteDance Doubao Image Generation)
      • Chat (Stepfun)
      • Chat (Stepfun Multimodal)
      • Chat (iFLYTEK Spark)
      • Chat (SenseTime)
      • Chat(Minimax)
      • Chat (Tencent Hunyuan)
    • SiliconFlow
      • Chat(SiliconFlow)
    • Open Source Model
      • Chat(LLaMA4)
      • Chat(LLaMA3.3)
      • Chat(LLaMA3.2 multimodal)
      • Chat(LLaMA3.1)
      • Chat(Mistral)
      • Chat(Pixtral-Large-2411multimodal)
      • Chat(Gemma-7B、Gemma-3-27b-it)
      • Chat(Gemma2-9B)
      • Chat(Command R+)
      • Chat(Qwen2)
      • Chat(Qwen2.5)
      • Chat(Qwen2.5-VL)
      • Chat(Qwen3)
      • Chat(Llama-3.1-nemotron)
      • Chat(QwQ-32B、QwQ-Plus、QwQ-32B-Preview)
    • Expert Model
      • Chat(WiseDiag Medical Model)
      • Chat (ChatLaw Legal Model)
      • Chat (Xuanyuan Financial Model)
      • Chat (Farui Legal Model)
      • Chat (Alibaba Math Model)
      • Chat(Perplexity search)
    • Other Models
      • Chat(grok-3)
      • Chat(grok-2)
      • Chat(grok-2-vision)
      • Chat(Nova)
  • Image Generation
    • Unified interface
      • Generate images
    • GPT-Image-1
      • Generations(Image generation)
      • Edits(Modify Image)
    • DALL.E
      • Generations(DALL·E 3和DALL·E 2)
      • Edits(DALL·E 2)
      • Variations(DALL·E 2)
    • Stability.ai
      • Text-to-image (Image Generation-V1)
      • Generate (Image Generation-SD2)
      • Generate (Image Generation-SD3-Ultra)
      • Generate (Image Generation-SD3)
      • Generate(Image Generation-SD3.5-Large)
      • Generate(Image Generation-SD3.5-Medium)
      • Generate(Image to Image-SD3)
      • Generate(Image to Image-SD3.5-Large)
      • Generate(Image to Image-SD3.5-Medium)
    • Midjourney
      • Imagine
      • Action
      • Blend
      • Describe
      • Modal
      • Fetch
      • Cancel
    • Midjourney-Relax
      • Imagine
      • Action
      • Blend
      • Describe
      • Modal
      • Fetch
      • Cancel
    • 302.AI
      • SDXL
      • SDXL-Lora
      • SDXL-Lightning
      • SDXL-Lightning-V2
      • SDXL-Lightning-V3
      • SD3
      • SD3-V2
      • Aura-Flow
      • Kolors
      • Kolors(Reference Image Generation-KLING)
      • QRCode Generation
      • Lora
      • SD-3.5-Large
      • SD-3.5-Large-Turbo
      • SD-3.5-Medium
      • Lumina-Image-V2(Image generated)
      • Playground-v25(Image generated)
      • Omnigen-V1(Image generated)
    • Glif
      • Glif(Claude+SD3)
      • Glif (Text-to-Sticker)
      • Glif (Text-to-Graffiti)
      • Glif (Text-to-Wojak Comic)
      • Glif (Text-to-Lego)
    • Flux
      • Official API
        • Generate
        • Finetune
        • Result
      • Flux-Ultra(v1.1)
      • Flux-Pro
      • Flux-Pro(v1.1)
      • Flux-Dev
      • Flux-Schnell
      • Flux-Realism
      • Flux-Lora
      • Flux-General
      • Flux-General-Inpainting(Advanced Customization)
      • Flux-Lora-Training(Training Lora)
      • Flux-Lora-Training(Fetch Results Asynchronously)
    • Ideogram
      • Generate(Text to ImageV3)
      • Generate(Text to Image)
    • Recraft
      • Recraft-V3(Text to Image)
      • Create-Style(Customized Styles)
      • Recraft-20B(Image Generation)
    • Luma
      • Luma-Photon(Image generation)
      • Luma-Photon-Flash(Fast image generation)
    • Doubao
      • Drawing(Doubao image generation)
    • Google
      • Imagen-3 (Image generated)
      • Imagen-3-Fast (Image generated)
    • Minimax
      • image(Text-to-Image Generation)
    • ZHIPU
      • image(Text-to-Image Generation)
    • Baidu
      • iRAG(Text-to-Image Generation)
    • Hidream
      • Hidream-i1-full(Advanced Version)
      • Hidream-i1-dev(Intermediate Version)
      • Hidream-i1-fast(Entry-Level Version)
  • Image Processing
    • 302.AI
      • Upscale
      • Upscale-V2
      • Upscale-V3
      • Upscale-V4
      • Super-Upscale
      • Super-Upscale-V2
      • Face-upscale
      • Colorize
      • Colorize-V2
      • Removebg
      • Removebg-V2
      • Inpaint
      • Erase
      • Face-to-many
      • Llava
      • Relight
      • Relight-background
      • Relight-V2
      • Face-swap-V2
      • Fetch
      • HtmltoPng
      • SvgToPng
      • image-translate
      • image-translate-query
      • image-translate-redo
      • Flux-selfie
      • Trellis(Image to 3D model)
      • Pose-Transfer(Human Pose Transformation)
      • Pose-Transfer(Human Pose Transformation Result)
      • Virtual-Tryon
      • Virtual-Tryon(Fetch Result)
      • Denoise(AI Denoising)
      • Deblur(AI Deblurring)
    • 302.AI-ComfyUI
      • Create Outfit Change Task
      • Create Outfit Change Task (Upload Mask)
      • Query Outfit Change Task Status
      • Create Face Swap Task
      • Query Face Swap Task Status
      • Create a Task to Replace Any Item
      • Create Object Replacement Task (Upload Mask)
      • Check the Status of Any Object Replacement Task
      • Create a Task to Transform Cartoon Characters into Real People
      • Query the status of the task to turn a manga character into a real person
      • Create Style Transfer Task
      • Query the status of the style transfer task
      • Create Image Removal Task
      • Query Image Removal Task Status
      • Create Video Face Swap Task
      • Query Video Face Swap Task Status
    • Vectorizer
      • Vectorize
    • Stability.ai
      • Fast Upscale
      • Creative Upscale
      • Conservative Upscale
      • Fetch
      • Erase
      • Inpaint
      • Outpaint
      • Search-and-replace
      • Search-and-recolor
      • Remove-background
      • Sketch
      • Structure
      • Style
      • Replace-Background
      • Stable-Fast-3D
      • Stable-Point-3D(Image to 3D Model Conversion -New Version)
    • Glif
      • Glif(Portrait Photo Stylization)
      • Glif(Photo-to-Sculpture)
      • Glif(Photo Pixelation)
      • Glif(Logo Materialization)
      • Glif(Image-to-GIF)
    • Clipdrop
      • Cleanup
      • Upscale
      • Remove-background
      • Uncrop
    • Recraft
      • Vectorize Image
      • Remove Background
      • Clarity Upscale
      • Generative Upscale
    • BRIA
      • Remove Background
      • Blur Background
      • Generate Background
      • Erase Foreground
      • Eraser
      • Expand Image
      • Increase Resolution
      • Crop
      • Cutout
      • Packshot
      • Shadow
      • Scene
      • Caption
      • Register
      • Mask
      • Presenter info
      • Modify Presenter
      • Delayer Image
    • Flux
      • Flux-V1.1-Ultra-Redux(Image-to-image generation-Ultra)
      • Flux-V1.1-Pro-Redux(Image-to-image generation-Pro)
      • Flux-Dev-Redux(Image-to-image generation-Dev)
      • Flux-Schnell-Redux(Image-to-image generation-Schnell)
      • Flux-V1-Pro-Canny(Object consistency)
      • Flux-V1-Pro-Depth(Depth consistency)
      • Flux-V1-Pro-Fill(Partial repainting)
    • Hyper3D
      • Hyper3d-Rodin(Generate 3D models)
      • Hyper3d-Rodin(Obtain task results)
    • Tripo3D
      • Task(Task Submission)
      • Upload(Image Upload)
      • Fetch
    • FASHN
      • Fashn-Tryon(Virtual Try-On)
      • Fashn-Tryon(Virtual Try-On v1.5)
    • Ideogram
      • Edit(Image EditionV3)
      • Remix(Image to ImageV3)
      • Reframe(Image ExtensionV3)
      • Replace Background(V3)
      • Remix(Image to Image)
      • Upscale(Image Upscaling)
      • Describe(Image Description)
      • Edit(Image Edition)
    • Doubao
      • SeedEdit(Image Command Editing)
        POST
      • Character(Character Feature Preservation)
        POST
    • Kling
      • Virtual-Try-On
      • Fetch(Get Task Result)
    • StepFun
      • Step1x-Edit(Modify Image)
  • Video Generation
    • Unified Interface
      • Create Video Generation Task
      • Retrieve Video Task Information
    • 302.AI
      • Image-to-video
      • Live-portrait
      • Video-To-Video
      • Fetch
      • Latentsync (Open source digital person)
      • Latentsync (get task results)
      • Upscale-Video(Video Enhancement)
      • Upscale-Video(Get Video Results)
    • Stable Diffusion
      • Image-to-video
      • Fetch Image-to-video
    • Luma AI
      • Submit(Text / Image to Video)
      • Extend(Video)
      • Fetch
    • Runway
      • Submit(Text to Video)
      • Submit(Image to Video)
      • Submit(Image to Video Rapid)
      • Submit(Image-to-Video Generation with Gen4)
      • Submit(Image to Video Generation Gen4-Turbo)
      • Submit(Video to Video)
      • Submit(Video to Video Rapid)
      • Submit(Act-one motion capture)
      • Submit(Video extension)
      • Fetch
    • Kling
      • Txt2Video(Text to Video 1.0 Rapid-5s)
      • Txt2Video_HQ(Text to Video 1.5 HQ-5s)
      • Txt2Video_HQ(Text to Video 1.5 HQ-10s)
      • Image2Video(Image to Video 1.0 Rapid-5s)
      • Image2Video(Image to Video 1.0 Rapid-10s)
      • Image2Video(Image to Video 1.5 Rapid-5s)
      • Image2Video(Image to Video 1.5 Rapid-10s)
      • Image2Video_HQ(Image to Video 1.5 HQ-5s)
      • Image2Video_HQ(Image to Video 1.5 HQ-10s)
      • Txt2Video(Text to Video 1.6 Standard-5s)
      • Txt2Video(Text to Video 1.6 Standard-10s)
      • Txt2Video(Text to Video 1.6 HQ-5s)
      • Txt2Video(Text to Video 1.6 HQ-10s)
      • Image2Video(Image to Video 1.6 Standard-5s)
      • Image2Video(Image to Video 1.6 Standard-10s)
      • Image2Video(Image to Video 1.6 HQ-5s)
      • Image2Video(Image to Video 1.6 HQ-10s)
      • Txt2Video(Text-to-Video 2.0 – HD – 5s)
      • Image2Video(Image-to-Video 2.0 – HD – 5s)
      • Image2Video(Image-to-Video 2.0 – HD – 10s)
      • Image2Video (Multiple pictures for reference)
      • Extend_Video
      • Fetch
    • CogVideoX
      • Generations (text-generated video)
      • Generations(Image-generated video)
      • Results (get task results)
    • Minimax
      • Video(Text-to-Video)
      • Video(Image-to-video)
      • Video(Based on Subject Reference)
      • Video(Camera movement control)
      • Query(Result)
      • Files(Video Download)
    • Pika
      • 1.5 pikaffects(Image-to-Video Generation)
      • Turbo Generate(Text-to-Video Generation)
      • Turbo Generate(Text-to-Video Generation)
      • 2.1 Generate(Text-to-Video Generation)
      • 2.1 Generate(Image-to-Video Generation)
      • 2.2 Generate(Text-to-Video Generation)
      • 2.2 Generate(Image-to-Video Generation)
      • 2.2 Pikascenes(Generate scene videos)
      • Fetch(Result)
    • PixVerse
      • Pixverse Special Effect ID
      • Pixverse Sound Effect ID
      • Generate
      • Fetch
    • Genmo
      • Mochi-v1 (Get task results)
      • Mochi-v1(Text to Video)
    • Hedra
      • Audio(Upload)
      • Portrait(Upload)
      • Characters(lip-synthesis)
      • Fetch(Result)
    • Haiper
      • Haiper(Text to Video)
      • Haiper(Image to Video)
      • Haiper(Text to Video V2.5)
      • Haiper(Image to Video V2.5)
      • Haiper(Fetch Task Result)
    • Sync.
      • Generate
      • Fetch
    • Lightricks
      • Ltx-Video
      • Ltx-Video-I2V
      • Ltx-Video-v095(Text-to-video generation)
      • Ltx-Video-v095-I2V(Image-to-Video Generation)
    • Hunyuan
      • Hunyuan(Text-to-Video)
      • Hunyuan(Obtain Task Results)
    • Vidu
      • Vidu(Text-to-Video)
      • Vidu(Image to Video)
      • Vidu(Generate video from the first and last frames)
      • Vidu(Reference-based video generation)
      • Vidu(Generate scene video)
      • Vidu(Smart Ultra HD)
      • Fetch(Retrieve Task Results)
      • Vidu V2(Text-to-Video Generation)
      • Vidu V2(Image-to-Video)
      • Vidu V2(Start-and-End Frame Video Generation)
      • Vidu V2(Subject-Driven Video Generation)
      • Vidu(Scene Video Generation V2)
      • Vidu V2(AI Ultra HD – Premium)
      • Fetch V2(Retrieve Task Result)
    • Tongyi Wanxiang
      • T2V(Text-to-Video)
      • Tasks(Fetch Task Result)
      • wan-t2v(Text-to-video open source version)
      • wan-t2v(Fetch Task Result)
      • wan-i2v(Image-to-video open source version)
      • wan-i2v(Fetch Task Result)
    • Jimeng
      • Seaweed (Text/picture generated video)
      • Seaweed (Fetch Task Results)
    • SiliconFlow
      • LTX-Video(Video Generation)
      • HunyuanVideo(Video Generation)
      • Mochi-1-Preview(Video Generation)
      • Tasks(Fetch Task Result)
    • Google
      • Veo2(Text-to-video)
      • Veo2(Get task results)
    • Kunlun Tech
      • Skyreels(Image to Video)
      • Skyreels(Get task results)
    • Higgsfield
      • Generate(Image to Video)
      • Fetch(Retrieve Task Results)
  • Audio/Video Processing
    • Unified interface
      • TTS
        • Text-to-Speech Generation
        • Query TTS Provider Information
    • 302.AI
      • Stable-Audio(instrumental generation)
      • Transcript (Audio/Video to Text)
      • Transcriptions(Speech to Text)
      • Alignments(Subtitle Timing)
      • WhisperX
      • F5-TTS(Text to Speech)
      • F5-TTS (Asynchronous Text-to-Speech)
      • F5-TTS (Asynchronously Retrieve Results)
      • mmaudio(Text-to-Speech)
      • mmaudio(AI Video Voiceover)
      • mmaudio (Asynchronous Result Retrieval)
      • Diffrhythm(Song Generation)
    • OpenAI
      • Speech(Text to Speech tts-1)
      • Transcriptions(Speech to Text whisper-1)
      • Translations(Speech to English Text whisper-1)
      • Realtime
    • Azure
      • AzureTTS(Text to Speech)
      • Voice-List
    • Suno
      • Music(Automatic Mode)
      • Music(Custom Mode)
      • Music(Generate Lyrics)
      • Music(Song Continuation)
      • Fetch
    • Doubao
      • tts_hd(Text to Speech)
      • vc-ata(Automatic subtitle timing)
      • fetch(Query Generation Status)
      • vc(Audio and video caption generation)
      • fetch(Query caption result)
    • Fish Audio
      • TTS(Text to Speech)
      • Model(Create Voice)
      • Model(Obtain Voice)
      • Model(Delete Voice)
      • Model(Update Voice)
      • Model(Get Voice List)
    • Minimax
      • T2A(Async extra content generation)
      • T2A(Status Inquiry)
      • T2V(Create Voice)
      • Files(Audio File Download)
      • Music_Upload(Upload original music)
      • Music Generation API
      • T2A (voice generation-synchronization)
    • Dubbingx
      • TTS(Text to Speech)
      • GetTTSList(Get Voice List)
      • GetTTSTask(Get Task Status)
      • Analyze(emotions)
    • Udio
      • Generate(Music Generation)
      • Generate(Music Continuation)
      • Query
    • Elevenlabs
      • Speech-to-text(Speech-to-Text)
      • Speech-to-text(Asynchronously fetch results)
      • TTS-Multilingual-v2(Text-to-Speech)
      • TTS-Multilingual-v2(Asynchronous result retrieval)
      • TTS-Flash-v2.5(Text-to-Speech)
      • TTS-Flash-v2.5(Asynchronous result retrieval)
    • Mureka
      • Upload Music
      • Generate Lyrics from a Prompt
      • Continue writing lyrics from existing lyrics
      • Generate a Song from Lyrics
      • Retrieve the Generated Song
      • Separate Music Stems
      • Generate Instrumental Music Track
      • Retrieve Instrumental Music Track
      • Text-to-Speech
      • Create Podcast Audio
  • Information Processing
    • Unified Search API
      • Unified Search API
    • 302.AI
      • Admin Dashboard
        • Balance(Account balance)
        • Price(Get API Pricing)
        • Retrieve User API Keys List Data
        • Retrieve Data for Specified API Key
        • Create API Key
        • Update API Key
        • Delete API Key
      • Information search
        • Xiaohongshu_Search
        • Xiaohongshu_Note
        • Get_Home_Recommend
        • Tiktok_Search
        • Douyin_Search
        • Twitter_Search
        • Twitter_Post(X_Post)
        • Twitter_User(X_User)
        • Weibo_Post
        • Search_Video
        • Youtube_Info
        • Youtube_Subtitles(Youtube Obtain Subtitles)
        • Bilibili_Info(Bilibili Obtain Video Information)
        • MP_Article_List(Get the list of WeChat official account articles)
        • MP_Article(Retrieve WeChat Official Account articles)
      • File processing
        • Parsing
        • Upload-File
      • Code execution
        • Virtual Machine Sandbox
          • One-click Code Execution
          • Create Sandbox
          • Query Your Sandbox List
          • Destroy Sandbox
          • Run-Code
          • Run Command Line
          • Query File Information at Specified Path
          • Import File Data into Sandbox
          • Export Sandbox Files
        • Static Sandbox
          • Run-Code
      • Remote Browser
        • Create Browser Automation Task
        • Query Browser Task Status
    • Tavily
      • Search
      • Extract
    • SearchAPI
      • Search
      • Search(News)
      • Search(Images)
      • Search(Lens)
      • Search(Videos)
      • Search(Scholar)
      • Search(Patents)
    • Search1API
      • Search
      • News
      • Crawl
      • Sitemap(Site Map)
      • Trending (Popular Trends)
    • Exa
      • Search
      • Contents(Get content)
      • Answer
    • Bocha AI
      • Web-search
      • Ai-search
    • Doc2x
      • Version 2
        • PDF(Upload - Asynchronous)
        • Status(View Status)
        • Parse(Request Export File - Asynchronous)
        • Result(exported results)
      • Version 1 (Deprecated)
        • PDF(PDF-to-MD)
        • PDF-Async
        • IMG-to-MD
        • IMG-Async
        • Status
        • Export
    • Glif
      • Glif(Bot)
    • Jina
      • Reader(Web Page to Markdown)
      • Search
      • Grounding(Verification of Facts)
      • Classify
    • DeepL
      • Chat(Translate into English)
      • Chat(Translate into Chinese)
      • Chat(Translate into Japanese)
      • Translate(Translate into various language)
    • RSSHub
      • RSSHub
    • Firefly card
      • saveImg(Card Generation)
    • Youdao
      • Youdao(Youdao Translate)
    • Mistral
      • OCR(PDF Parsing)
    • Firecrawl
      • Scrape
      • Batch Scrape
      • Get Batch Scrape Status
      • Get Batch Scrape Errors
      • Map
      • Search
  • RAG-related
    • OpenAI
      • Embeddings
    • Jina
      • Embeddings
      • Rerank
      • Rerank(Multimodal Reordering)
      • Tokenizer
    • China Model
      • Embeddings(Zhipu)
      • Embeddings(BAAI)
      • Embeddings(Baichuan AI)
      • Embeddings(Youdao)
      • Rerank(Youdao)
      • Rerank(BAAI)
    • 302.AI
      • Chat(with KB)
      • Chat(with KB-OpenAI compatible)
      • Create(Knowledge Base)
      • Delete(Knowledge Base)
      • Upload
      • List(KB)
      • Info
      • Meta-Chunking(Text LLM slices)
      • Meta-Chunking(File LLM slices)
  • Tools API
    • AI Video Creation Hub
      • Scripts(Generate Video Content Copy)
      • Terms(Generate Video Material Search Keywords)
      • Videos(Create Video Material Generation Task)
      • Tasks(Get Video Task Progress)
    • AI Paper Writing
      • CO-STORM
        • Create generate article task
        • Continue to generate dialogue interfaces
        • Update article content interface
        • Get article information
      • Asynchronous Paper Generate
      • Fetch
    • AI Podcast Production
      • Asynchronous Generate Podcast Transcripts
      • Check the status of podcast text generation task
      • Asynchronously Generate Podcast Audio
      • Check the status of podcast audio generation task
    • AI Writing Assistant
      • Get Tools‘ List
      • Generate Copywriting
    • AI Video Real-Time Translation
      • Query Video Information
      • Video Download
      • Extract Audio from Video
      • Audio vocal separation and transcription
      • Subtitle Translation
      • Video Burning
      • Original sound clone
      • Query task status
    • AI Document Editor
      • Generate a long text outline
      • Generate article content
    • Web Data Extraction Tool
      • Generate Schema
      • Create an extraction task
      • Query extraction progress
    • AI Prompt Expert
      • Prompt Optimization
      • Image prompt generation
      • Create SPO Prompt Optimization Task
      • Query SPO Prompt Optimization Results
    • AI 3D Modeling
      • 3D model file type conversion
    • AI Search Master 3.0
      • AI Search
    • AI Vector Graphics Generation
      • SVG to video
    • Al Answer Machine
      • Answer
    • AI PPT Generator
      • Generate PPT interface with one click
      • File parsing
      • Generate an outline
      • Generate outline content
      • Get template options
      • Generate PPT interface (synchronous interface)
      • Load PPT data
      • Generate PPT interface (asynchronous interface)
      • Asynchronous query generates PPT status
      • Download PPT
      • Add/update custom PPT templates
      • Pagination query PPT template
    • AI Academic Paper Search
      • arxiv Paper Search
      • Google Paper Search
    • One-Click Website Deployment
      • Create Hosted Webpage (Form Parameter API)
      • Create Hosted Webpage (JSON Parameter API)
      • Create Hosted Webpage (Binary Parameter API)
      • Query the List of Hosted Projects under an API Key
    • AI Avatar Maker
      • Generate Avatar (JSON Parameter Example)
      • Avatar Generation (form-data parameter example)
    • AI Card Generation
      • Generate Knowledge Card
      • Generate Poster
      • Generate philosophical cards
      • Generate philosophical quotation sayings
  • Help Center
    • HTTP Status Codes
    • List of supported languages for image translation
  1. Doubao

Character(Character Feature Preservation)

POST
/doubao/drawing/character
Image generation model from SeedEdit
The General 2.0 - Character Feature Preservation model (formerly known as General 2.0S - Subject Preservation) integrates proprietary subject preservation technology, which includes both subject appearance preservation and facial feature preservation.The subject appearance information covers a wide range of subjects, including humans, animals, and objects. During the image generation process, both subject appearance and facial features work together with the input text to produce images that not only align with the appearance of the subject in the reference image but also match the textual description.
Introduction:https://www.volcengine.com/docs/6791/1361423
Price:0.05 PTC/call

Request

Header Params
Authorization
string 
required
Example:
Bearer {{YOUR_API_KEY}}
Body Params application/json
prompt
string 
required
Prompts for generating images, input in both Chinese and English
You can input prompts in either Chinese or English to generate images. To improve the accuracy of the text written in the image, enclose the desired text in quotation marks. For example:
"A Christmas poster with the text 'Merry Christmas' written on it."
image_urls
string 
required
Image File URL.This algorithm requires a input image
seed
integer 
optional
Random seed,Used as the basis to determine the initial state of diffusion. The default value is -1 (random). If the random seed is set to the same positive integer and all other parameters remain identical, the generated images are highly likely to be consistent.
Default value: -1
scale
number 
optional
Influence of Text Description
Default value: 3.5
Value range: [1, 10]
return_url
boolean 
optional
Specifies whether the output should include an image link (the link will be valid for 24 hours)
logo_info
object 
optional
Watermark information
add_logo
boolean 
optional
position
integer 
optional
The position of the watermark can be set as follows:
0: Bottom right (default)
1: Bottom left
2: Top left
3: Top right
language
integer 
optional
The language of the watermark can be set as follows:
0: Chinese (AI生成) (default)
1: English (Generated by AI)
opacity
number 
optional
The opacity of the watermark can be set within the range of 0 to 1, where 1 represents fully opaque. The default value is 0.3
logo_text_content
string 
optional
Custom content for visible watermark
ddim_steps
integer 
optional
Steps for Image Generation
Default Value:9
Value Range:[1, 200]
width
integer 
optional
Width of Generated Image (Before Upscaling)
Default Value:512
Value Range:[256, 768]
height
integer 
optional
Height of Generated Image (Before Upscaling)
Default Value:512
Value Range:[256, 768]
cfg_rescale
number 
optional
Default Value:0.7
ref_ip_weight
number 
optional
Weight of Reference Image's Subject Appearance
The higher the weight, the greater the similarity between the generated result and the subject in the reference image.
Default Value:0.7
Value Range:[0, 1]
ref_id_weight
number 
optional
Weight of facial features from reference image,the higher the weight, the greater the similarity between the generated result and the facial features in the reference image.
Default Value: 0.36
Value Range: [0, 1]
Recommended Range: [0.2, 0.4]
use_sr
boolean 
optional
true:Text-to-Image + AIGC Upscaling
false:Text-to-Image
Default Value:true
Example
{
  "image_urls": [
    "https://xxx"
  ],
  "prompt": "千军万马",
  "desc_pushback": true,
  "seed": -1,
  "scale": 3.5,
  "ddim_steps": 9,
  "width": 512,
  "height": 512,
  "cfg_rescale": 0.7,
  "ref_ip_weight": 0.7,
  "ref_id_weight": 0.36,
  "use_sr": true,
  "return_url": true,
  "logo_info": {
    "add_logo": false,
    "position": 0,
    "language": 0,
    "opacity": 0.3,
    "logo_text_content": "这里是明水印内容"
  }
}

Request 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 --request POST 'https://api.302.ai/doubao/drawing/character' \
--header 'Authorization: Bearer sk-jls4AaVBGoe1GwZD64qZA1qyKTN1MPHa4NmvH1cT68z7K1Zz' \
--header 'Content-Type: application/json' \
--data-raw '{
    "image_urls": ["https://xxx"],
    "prompt": "千军万马",
    "desc_pushback": true,
    "seed": -1,
    "scale": 3.5,
    "ddim_steps": 9,
    "width": 512,
    "height": 512,
    "cfg_rescale": 0.7,
    "ref_ip_weight": 0.7,
    "ref_id_weight": 0.36,
    "use_sr": true,
    "return_url": true,
    "logo_info": {
        "add_logo": false,
        "position": 0,
        "language": 0,
        "opacity": 0.3,
        "logo_text_content": "这里是明水印内容"
    }
}'

Responses

🟢200OK
application/json
Body
completed_at
string 
required
created_at
string 
required
error
string 
required
id
string 
required
model
string 
required
output
string 
required
started_at
string 
required
status
string 
required
Example
{
  "completed_at": "",
  "created_at": "",
  "error": "",
  "id": "",
  "model": "",
  "output": "",
  "started_at": "",
  "status": ""
}
Previous
SeedEdit(Image Command Editing)
Next
Virtual-Try-On
Built with