Skip to main content
ideogram-data-handling Manage Ideogram generated image assets, metadata tracking, and lifecycle management.
Use when implementing image persistence, tracking generation history,
or building asset management for Ideogram outputs.
Trigger with phrases like "ideogram data", "ideogram images",
"ideogram asset management", "ideogram metadata", "ideogram image storage".
설치로 이동 Skills Marketplace 커뮤니티가 만든 AI 스킬을 발견하고 탐색하세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill ideogram-data-handling명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Zip 다운로드 다운로드 중... 이 저장소의 다른 Skills Implement user sign-up and sign-in flows with Clerk.
Use when building authentication UI, customizing sign-in experience,
or implementing OAuth social login.
Trigger with phrases like "clerk sign-in", "clerk sign-up",
"clerk login flow", "clerk OAuth", "clerk social login".
Implement session management and middleware with Clerk.
Use when managing user sessions, configuring route protection,
or implementing token refresh and custom JWT templates.
Trigger with phrases like "clerk session", "clerk middleware",
"clerk route protection", "clerk token", "clerk JWT".
Configure enterprise SSO, role-based access control, and organization management.
Use when implementing SSO integration, configuring role-based permissions,
or setting up organization-level controls.
Trigger with phrases like "clerk SSO", "clerk RBAC",
"clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".
jeremylongshore
jeremylongshore/claude-code-plugins-plus-skills
GitHub 저장소 열기 name ideogram-data-handling description Manage Ideogram generated image assets, metadata tracking, and lifecycle management.
Use when implementing image persistence, tracking generation history,
or building asset management for Ideogram outputs.
Trigger with phrases like "ideogram data", "ideogram images",
"ideogram asset management", "ideogram metadata", "ideogram image storage".
allowed-tools Read, Write, Edit version 1.10.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> tags ["saas","ideogram","data","asset-management"] compatibility Designed for Claude Code, also compatible with Codex and OpenClaw
Ideogram Data Handling
Overview
Manage generated image assets from Ideogram's API. Critical concern: Ideogram image URLs expire (approximately 1 hour). Every generation must be downloaded and persisted immediately. This skill covers metadata tracking, download pipelines, local and cloud storage, lifecycle management, and generation history for reproducibility.
Prerequisites
IDEOGRAM_API_KEY configuredStorage solution (local filesystem, S3, or GCS)
Database for generation metadata (SQLite, Postgres, or JSON files)
Instructions
Step 1: Generation Record Schema
interface GenerationRecord {
id : string ;
prompt : string ;
expandedPrompt ?: string ;
negativePrompt ?: string ;
model : string ;
styleType : string ;
aspectRatio : string ;
seed : number ;
resolution : string ;
isSafe : boolean ;
originalUrl : string ;
storedPath : string
createdAt
string
sizeBytes
number
tags
string
Step 2: Generate, Download, and Track import { writeFileSync, mkdirSync, statSync } from "fs" ;
import { join } from "path" ;
import { randomUUID } from "crypto" ;
const STORAGE_DIR = "./generated-images" ;
const records : GenerationRecord [] = [];
async function generateAndPersist (
prompt : string ,
options : {
model?: string ;
style_type?: string ;
aspect_ratio?: string ;
negative_prompt?: string ;
seed?: number ;
tags?: string [];
} = {}
): Promise <GenerationRecord > {
const response = await fetch ("https://api.ideogram.ai/generate" , {
method : "POST" ,
headers : {
"Api-Key" : process.env .IDEOGRAM_API_KEY !,
"Content-Type" : "application/json" ,
},
body : JSON .stringify ({
image_request : {
prompt,
model : options.model ?? "V_2" ,
style_type : options.style_type ?? "AUTO" ,
aspect_ratio : options.aspect_ratio ?? "ASPECT_1_1" ,
magic_prompt_option : "AUTO" ,
negative_prompt : options.negative_prompt ,
seed : options.seed ,
},
}),
});
if (!response.ok ) throw new Error (`Generation failed: ${response.status} ` );
const result = await response.json ();
const image = result.data [0 ];
const imgResp = await fetch (image.url );
if (!imgResp.ok ) throw new Error (`Download failed: ${imgResp.status} ` );
const buffer = Buffer .from (await imgResp.arrayBuffer ());
mkdirSync (STORAGE_DIR , { recursive : true });
const filename = `${image.seed} -${Date .now()} .png` ;
const storedPath = join (STORAGE_DIR , filename);
writeFileSync (storedPath, buffer);
const record : GenerationRecord = {
id : randomUUID (),
prompt,
expandedPrompt : image.prompt !== prompt ? image.prompt : undefined ,
negativePrompt : options.negative_prompt ,
model : options.model ?? "V_2" ,
styleType : image.style_type ?? options.style_type ?? "AUTO" ,
aspectRatio : options.aspect_ratio ?? "ASPECT_1_1" ,
seed : image.seed ,
resolution : image.resolution ,
isSafe : image.is_image_safe ,
originalUrl : image.url ,
storedPath,
createdAt : new Date ().toISOString (),
sizeBytes : buffer.length ,
tags : options.tags ,
};
records.push (record);
saveRecords ();
return record;
}
function saveRecords (writeFileSync (
join (STORAGE_DIR , "generations.json" ),
JSON .stringify (records, null , 2 )
);
}
Step 3: Cloud Storage (S3) import { S3Client, PutObjectCommand , DeleteObjectCommand } from "@aws-sdk/client-s3" ;
const s3 = new S3Client ({ region : process.env .AWS_REGION });
async function persistToS3 (imageUrl : string , seed : number Promise <string > {
const response = await fetch (imageUrl);
const buffer = Buffer .from (await response.arrayBuffer ());
const key = `ideogram/${seed} -${Date .now()} .png` ;
await s3.send (new PutObjectCommand ({
Bucket : process.env .S3_BUCKET !,
Key : key,
Body : buffer,
ContentType : "image/png" ,
CacheControl : "public, max-age=31536000, immutable" ,
Metadata : { seed : String (seed), source : "ideogram" },
}));
return `https://${process.env.CDN_DOMAIN} /${key} ` ;
}
Step 4: Reproduction from Seed
async function reproduceImage (record : GenerationRecord return generateAndPersist (record.prompt , {
model : record.model ,
style_type : record.styleType ,
aspect_ratio : record.aspectRatio ,
negative_prompt : record.negativePrompt ,
seed : record.seed ,
tags : [...(record.tags ?? []), "reproduced" ],
});
}
Step 5: Lifecycle Management import { unlinkSync, existsSync, readdirSync, statSync } from "fs" ;
function cleanupOldAssets (retentionDays : number = 30 const cutoffMs = Date .now () - retentionDays * 86400000 ;
let deleted = 0 ;
let kept = 0 ;
for (const record of records) {
const createdMs = new Date (record.createdAt ).getTime ();
if (createdMs < cutoffMs) {
if (existsSync (record.storedPath )) {
unlinkSync (record.storedPath );
deleted++;
}
} else {
kept++;
}
}
const activeRecords = records.filter (
r =>new Date (r.createdAt ).getTime () >= cutoffMs
);
records.length = 0 ;
records.push (...activeRecords);
saveRecords ();
console .log (`Cleanup: deleted ${deleted} , kept ${kept} ` );
}
function storageReport (const totalBytes = records.reduce ((sum, r ) => sum + (r.sizeBytes ?? 0 ), 0 );
const byModel = Object .groupBy (records, r =>model );
console .log ("=== Image Storage Report ===" );
console .log (`Total images: ${records.length} ` );
console .log (`Total size: ${(totalBytes / 1024 / 1024 ).toFixed(1 )} MB` );
for (const [model, recs] of Object .entries (byModel)) {
console .log (` ${model} : ${recs?.length ?? 0 } images` );
}
}
Step 6: Search and Query function findByPrompt (searchTerm : string GenerationRecord [] {
return records.filter (r =>prompt .toLowerCase ().includes (searchTerm.toLowerCase ())
);
}
function findBySeed (seed : number GenerationRecord | undefined {
return records.find (r =>seed === seed);
}
function findByTags (tags : string []GenerationRecord [] {
return records.filter (r =>every (t =>tags ?.includes (t))
);
}
Error Handling Issue Cause Solution Expired URL Downloaded too late Always download in same function Disk full Too many stored images Run cleanupOldAssets() regularly Missing metadata Not tracked at generation Use generateAndPersist wrapper Duplicate prompts Same prompt run twice Check by prompt hash before generating Lost seed Not recorded Always store seed from response
Output
Generation records with full metadata tracking
Immediate download preventing URL expiration
S3 cloud storage with CDN delivery
Seed-based reproduction for exact image regeneration
Lifecycle management with configurable retention
Resources
Next Steps For access control, see ideogram-enterprise-rbac.
