iApp Image Generation

根据泰文或英文描述生成图像，您提供的文字在画面中按原文准确呈现。

POST/v3/store/image-generation/iapp-image-generation/generate试一试

• 价格1.5 IC每次请求
• 承载1,000 张/小时
• 累计调用12.3K次

• v1.1.3-20260904
• 运行中

输入

prompt

การ์ดอวยพรวันเกิดสีพาสเทล มีเค้กและลูกโป่ง ลายเส้นน่ารักแบบภาพประกอบ

text

สุขสันต์วันเกิด

font

itim

size

1024x1024

输出POST /v3/store/image-generation/iapp-image-generation/generate

status

success

id

20260902-054442-f26467

width

1024

height

1024

font

itim

text

สุขสันต์วันเกิด

mime_type

image/png

time

translate: 3.1 generate: 8.6 total: 11.8

iapp

images: 1 version: 1.0.0-20260902

全部字段见“响应”一节

用此 API 生成的图像

均由 v1.1.0 于 2026 年 9 月 3 日生成，未经编辑。点击图片可查看原图。

ก๋วยเตี๋ยวเรือ อร่อยมาก字体 kanit-bold

สวัสดีปีใหม่字体 kanit-bold

ยินดีต้อนรับสู่ประเทศไทย字体 charm

ชาไทย 35 บาท字体 sriracha

น้ำปลาแท้字体 taviraj

กรุงเทพมหานคร 25 กม.字体 notosans

กาแฟบ้านสวน字体 mitr

ทุเรียนหมอนทอง字体 sriracha

请求

curl -X POST https://api.iapp.co.th/v3/store/image-generation/iapp-image-generation/generate \
  -H "apikey: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ \
    "prompt": "การ์ดอวยพรวันเกิดสีพาสเทล มีเค้กและลูกโป่ง ลายเส้นน่ารักแบบภาพประกอบ", \
    "text": "สุขสันต์วันเกิด", \
    "font": "itim", \
    "size": "1024x1024" \
  }'

响应

200成功。字段在"响应"一节说明。

{
  "status": "success",
  "id": "20260902-054442-f26467",
  "width": 1024,
  "height": 1024,
  "font": "itim",
  "text": ["สุขสันต์วันเกิด"],
  "mime_type": "image/png",
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAABAAAAAQACAIAAADwf7zU...",
  "time": { "translate": 3.1, "generate": 8.6, "total": 11.8 },
  "iapp": { "images": 1, "version": "1.0.0-20260902" }
}

请求

JSON，每次一张图；失败或被拒绝的请求不计费。预览期每张 1.5 IC；预览结束后按标价 3 IC 计费，至少提前 14 天公告。

请求头

apikeystring必填

您的 API 密钥，在控制台的 API Keys 中创建。

请求体

promptstring必填

场景描述，泰语或英语，最多 1,500 字符；描述中双引号内的文字也会精确绘制。说明文字位置、场景、光线和风格：两句话得到有设计感的画面，五个词只得到平淡的图。

textstring | array

必须出现在图中的文字，每项一行或带换行的字符串，最多 4 行、每行 120 字符。只在 prompt 里而不在 text 里的泰文不作保证。

fontstring

下方列表中的字体 id。默认 kanit-bold。

sizestring

1024x1024（默认）、1280x768、768x1280、1536x1024 或 1024x1536。

stylestring

附加到描述后的风格提示：photorealistic、flat vector、watercolor。

seedinteger

固定随机种子，以复现图像。

reference_imagestring

Base64 的 PNG、JPEG 或 WebP，可带 data: 前缀，最大 6 MB。生成图保留该图的主体、外观和风格，其余按描述。

personsarray

最多两个泰国公众人物 id，从左到右，来自下方的人物搜索：这是把特定人物放进画面的可靠方式，描述中键入的名字只是普通词语。

person_referencestring

off（默认）或 auto：扫描描述中以完整姓名或官方职务写出的知名泰国人物。建议改用 persons。

text_scalenumber

文字块宽度占图像的比例，0.2 至 0.9。默认 0.55。

端点	作用	价格
POST /v3/store/image-generation/iapp-image-generation/generate	生成一张图	每张 3 IC，预览期 1.5 IC
GET …/fonts	列出字体	免费
GET …/persons?q=	按姓名搜索泰国公众人物	免费
GET …/persons/portrait?id=	人物头像缩略图	免费
POST …/persons/detect	描述中识别出的人物，用于确认步骤	免费

19 种字体

均以 SIL Open Font License 发布。kanit-bold（默认）、kanit、prompt-bold、prompt：现代。sarabun-bold、sarabun：正式，适合文档。mitr：圆润。chakrapetch-bold：技术感、几何。athiti-bold：紧凑。k2d-bold：展示。notosans：中性无衬线。pridi、taviraj、notoserif：衬线。itim：活泼。mali、sriracha：手写。charm：草书手写。srisakdi：装饰。

人物：搜索、头像、检测

演示中 @ 选择器背后的免费端点，共享每个密钥每秒 20 次的限制。

• 搜索 GET …/persons?q=<name>&limit=<n>：泰文或拉丁字母姓名，完整或部分；q 为空时返回最常被请求的人物。limit 1 至 24，默认 12。每条结果含稳定的 id、泰文 name、name_en，任职者还有 role。
• 头像 GET …/persons/portrait?id=<id>&size=<px>：方形 JPEG，size 48 至 320，默认 128，缓存 24 小时；无头像时返回 404。
• 检测 POST …/persons/detect，请求体为 {"prompt": "…"}：描述中识别出的最多四人，各含 id、name、name_en、role、matched 文本及其 kind（role、full 或 short）。它从不自行添加任何人：用它询问用户谁应获得真实面孔，再把确认的 id 放入 persons。

响应

图像以 Base64 放在 image_base64，附 mime_type、width 和 height；所用的 font、text 和 seed；分为 translate、generate、total 的 time；以及 text_check，其 result 为 ok、duplicate、missing 或 extra，说明文字是否恰好出现一次。每个成功响应都带有 iapp-input-images: 1 头。

图像以 Base64 放在 image_base64，附 mime_type、width 和 height；所用的 font、text 和 seed；分为 translate、generate、total 的 time；以及 text_check，其 result 为 ok、duplicate、missing 或 extra，说明文字是否恰好出现一次。每个成功响应都带有 iapp-input-images: 1 头。

状态码

代码	含义
400	size、font 或某字段无效；消息指明字段
422	被内容安全过滤器拒绝：生成前为 prompt_rejected，图像检查后为 content_rejected；不计费
503	模型正在启动；60 秒后重试

详情

实测

指标	结果
泰文文字精确呈现，34 条提示的图库运行，2026 年 9 月 3 日	34 张中 32 张，94%
泰文文字逐字无误，11 条提示的验收集，2026 年 9 月 2 日	11 / 11
生成时间，1024 × 1024	20 至 45 秒
服务能力	每分钟约 17 张、每小时 1,000 张；超出即排队

限制

• 每个密钥的速率限制：每秒 2 次、每分钟 30 次、每小时 600 次。
• 文字保持所选字体的形状；霓虹光晕或粉笔纹理等效果只能部分呈现。
• 涉及色情、涉及未成年人的色情或极端血腥的描述在生成前即被拒绝，每张图生成后都会筛查；通过 persons 或 reference_image 描绘真人时，任何性暗示（包括泳装）都会被拒绝。

数据处理

描述与文字仅用于生成所请求的图像；图像随响应返回，并在 24 小时内删除。模型运行在 iApp 自有 GPU 上，没有描述或图像发送给第三方。服务符合 GDPR 与 PDPA。

更新日志

版本	日期	变更
v1.1.3-20260904	2026 年 9 月 4 日	泰国文化知识从 31 个概念扩展到取自泰文维基百科的 791 个，按词边界识别泰文或英文，且不误识别上下文中另有含义的词，50 条测试描述全部通过。
v1.1.2-20260904	2026 年 9 月 4 日	描述中提到的泰国事物（如制服、宋干节、出家、泰拳、孔剧、神龛和菜肴）按真实样貌呈现：12 条泰国文化提示中此前错 5 条，现在全部正确。
v1.1.1-20260904	2026 年 9 月 4 日	生成前后的内容安全过滤，姓名识别限于知名人物的全名、官方职务和名字，新增 POST …/persons/detect，人物端点限速每秒 20 次。
v1.1.0-20260903	2026 年 9 月 3 日	文字作为场景的实体部分呈现，响应新增 text_check，新增 reference_image，并通过 persons 支持来自 iApp Thai Famous People 数据集的 4,000 多位泰国公众人物。
v1.0.0-20260902	2026 年 9 月 2 日	预览发布：泰语和英语提示，19 种字体的精确泰文文字，五种尺寸，每张 1.5 IC。