ArtGen

ArtGen is a high-performance API that transforms mathematical algorithms into stunning, high-resolution visual assets. Generate unique, professional-grade artwork for social media and blog headers and print textures in seconds.

原始信息汇总

ArtGen API 数据集概述

基本信息

• API名称: ArtGen
• API类别: Video, Images
• 提供者: Mohammad Adnan Mahmood
• 订阅者数量: 1
• 当前版本: 1.0.0
• 服务等级: 91%
• 延迟: 622ms
• 测试率: 33%
• 流行度: 9

定价计划

• BASIC: $0.00 / 月
• PRO: $10.00 / 月

核心功能

• 随机生成: 使用随机和几何算法确保没有两个横幅完全相同。
• 完全可定制: 控制从调色板、几何密度到“艺术类型”的所有内容。
• 高分辨率输出: 支持行业预设和高达15,000px的自定义尺寸。
• 确定性艺术: 传递seed参数以在需要时重新创建完全相同的杰作。

可用艺术风格

• 有机: 地形、丝带和流动线条。
• 几何: 抽象多边形、对角线纹理和模数玫瑰花结。
• 动态: 径向耀斑和随机合并图案。

端点概述

• 配置: GET /v1/config
• 生成横幅: POST /v1/generate
• 生成随机艺术: POST /v1/generate/random
• 获取横幅: GET /v1/banners/{banner_id}
• 重新生成URL: GET /v1/banners/{banner_id}/url

艺术类型与算法

艺术类型	描述	特殊功能
ribbons	带有平滑渐变的流动丝带设计	优雅、流畅的运动
abstract	高对比度几何抽象设计	大胆而现代
topography	有机地形波浪图案	变体：特写、混合
diagonal_lines	流动对角线图案	微妙、专业的纹理
radial_flare	高能量径向耀斑图案	非常适合焦点
shattered_poly	破碎多边形/低多边形设计	科技前卫美学
stochastic	数学随机性图案	变体：professional_circles, merging_circles, merging_diamonds
modulo_circle	复杂的数学“玫瑰花结”艺术	参数：modulo, multiplier, rosette, petals, fill_shapes

尺寸选项

数字显示

• medium_rectangle: 300×250 px
• leaderboard: 728×90 px
• wide_skyscraper: 160×600 px
• half_page: 300×600 px
• large_rectangle: 336×280 px

社交媒体

• facebook_cover: 851×315 px
• twitter_header: 1500×500 px
• linkedin_personal: 1584×396 px
• linkedin_company: 1128×191 px
• youtube_channel_art: 2560×1440 px

移动端

• mobile_leaderboard: 320×50 px
• large_mobile_banner: 320×100 px

打印 (150 DPI)

• print_small (2×3): 3600×5400 px
• print_medium (3×6): 5400×10800 px
• print_large (5×8): 9000×14400 px
• print_retractable (33.5"×80"): 5025×12000 px

传统尺寸

• small: 800×150 px
• medium: 1200×200 px
• large: 1600×300 px

自定义尺寸

• 设置: size: "custom"
• 范围: 50px 至 15,000px
• 用途: 适用于高分辨率打印或特定的网页宽高比

集成快速入门

1. 获取可用选项: 调用 GET /v1/config 查看所有支持的艺术类型、调色板和尺寸预设。
2. 生成横幅: 调用 POST /v1/generate 并传入您选择的参数。
3. 生成随机艺术: 仅使用尺寸调用 POST /v1/generate/random 以获得惊喜结果。
4. 访问图像: 使用响应中提供的 image_url（有效期为24小时）。
5. 重新生成URL: 如果过期，调用 GET /v1/banners/{id}/url 获取新的签名URL。

速率限制

检查响应头以获取速率限制信息：

• X-RateLimit-Limit: 每分钟允许的最大请求数。
• X-RateLimit-Remaining: 当前窗口中的剩余请求数。
• X-RateLimit-Reset: 限制重置的UTC时间戳。

错误处理

API 为所有错误返回一致的 JSON 格式： json { "error_code": "VALIDATION_ERROR", "message": "The palette provided does not exist.", "request_id": "req_abc123xyz", "valid_options": ["ocean", "sunset", "neon", "forest"] }

• error_code: 用于编程处理的机器可读字符串。
• message: 错误的人类可读描述。
• request_id: 联系支持时包含此ID以获得更快的解决。
• valid_options: 在验证错误中提供，以帮助纠正请求。

API 版本控制

所有 API 端点都使用 /v1/ 前缀进行版本控制。遵循语义版本控制；在同一版本前缀内不会引入破坏性更改。

专业提示

• 提示 #1: 即时灵感: 当您需要新想法时，使用 /v1/generate/random 端点。它会为您选择随机算法和调色板，是发现您可能未考虑过的风格的最快方式。
• 提示 #2: 优化您的配额: 不要仅仅为了获取新链接而重新生成图像。如果原始的24小时链接已过期，请使用 id 来获取新的 image_url。