Pure Tokens Image
고정된 Pure Tokens Images API만 호출합니다: https://api.puretokensx.com/v1/images/generations. 정확한 모델 프로필이 선언된 경우에만 /v1/images/generations 또는 /v1/images/edits를 호출합니다. 매번 전체 고정 URL을 사용하며, 구성된 Base URL을 요청 대상으로 사용하지 않고 provider 이름도 확인하지 않습니다.
현재 호스트는 기존 인증 HTTPS/API 기능을 사용하여 현재 Pure Tokens 연결과 일치하는 자격 증명으로 요청을 완료합니다. 자격 증명은 메모리에서 이 고정된 요청 한 번에만 사용할 수 있습니다. 타사 CC Switch와 수동 호스트 구성 모두 이 연결의 출처가 될 수 있습니다. 키, Base URL, 요청 헤더, 전체 호스트 구성, 원시 응답 또는 사용자 미디어를 표시, 요청, 저장, 기록 또는 보고해서는 안 됩니다. Node, MCP, 프록시, 사이드카, 독립 업로드 또는 대체 엔드포인트를 사용해서는 안 됩니다.
필요 시 정보 읽기
모든 요청에서 모든 모델과 모든 예외 시나리오를 로드하지 마십시오. 다음 순서로 최소한으로 읽습니다:
- 먼저
references/model-index.json을 읽습니다: 기본 모델 또는 고유 별칭을 구문 분석하고 정확한 프로필 경로를 가져옵니다. - 선택한 모델의
references/profiles/<model>.json만 읽습니다: 매개변수, 제약 조건, 작업 및 수명 주기를 확인합니다. 인덱스에 없는 정확한 모델은 핵심 텍스트-이미지 필드만 허용합니다. 사용자가 추가 매개변수, 참조 이미지 또는 편집을 요청하는 경우에만 실시간 디렉토리를 필요에 따라 쿼리합니다. - 일반 핵심 POST는 이 스킬, 인덱스 및 선택한 프로필만을 기반으로 실행할 수 있습니다. 응답을 받고 폴링/전달 단계에 들어가거나 편집과 같은 비핵심 작업을 구성할 때
references/execution-contract.json및references/task-receipt.json을 읽습니다. - 해당 예외, 모호성, 거부, 첨부 파일 또는 전달 문제가 발생하는 경우에만
references/behavior-scenarios.json에서 일치하는 시나리오를 읽습니다.
모델 및 요청
- 일반 텍스트-이미지는 기본적으로
gpt-image-2입니다.image2는 유일한 별칭입니다. 사용자가 고유 별칭을 제공하면 인덱스 매핑을 사용합니다. 후보가 0개 또는 여러 개인 경우 정확한 ID를 나열하고 사용자에게 선택하도록 요청합니다. 사용자가 정확한 ID를 제공하면 해당 ID를 유지하며, 일반 핵심 요청은 권한이나 기능 확인을 위해 디렉토리를 미리 읽지 않아야 합니다. - 일반 요청은
POST /v1/images/generations를 한 번만 제출하며, 항상model,prompt,async: true를 포함합니다. 정확한 프로필이 선언하는 경우에만n,size,image_size,aspect_ratio,width,height,strength또는 기타 선택적 필드 및 값을 포함합니다. - 한 번의 사용자 요청으로 하나의 유료 작업만 생성할 수 있으며, 절대 분할하지 않습니다.
n은 프로필에 의해 명시적으로 허용되어야 합니다. 그렇지 않으면 한 번에 한 장만 지원하거나 사용자에게 해당 수량을 지원하는 모델을 선택하도록 안내합니다. 200cm × 230cm와 같은 물리적 크기는 API에 전송할 수 없습니다. 정확한 물리적 크기를 보장할 수 없다고 설명하고 프로필이 실제로 선언하는 픽셀 크기, 의미 크기 또는 비율 옵션을 나열합니다.width,height가 쌍으로 선언되어야 하는 경우 하나라도 없으면 중단됩니다. 여러 크기 표현이 동시에 제공되는 경우 프로필의 우선순위에 따라 하나만 제출합니다.- 사용자가 현재 모델에 대해 명시적으로 묻거나, 필요한 매개변수/작업이 로컬 프로필에 없거나, 첨부 파일 전송이 호환되지 않거나, API가 모델/매개변수/기능 때문에 거부한 후 설명이 필요한 경우에만
GET https://api.puretokensx.com/v1/media/models를 한 번 읽습니다. 디렉토리 읽기 실패는 원래 합법적인 핵심 텍스트-이미지 생성을 차단하지 않으며 자동 재시도를 트리거하지 않습니다.
참조 이미지 및 편집
- 사용자가 이미지를 첨부했지만 용도를 명시하지 않은 경우, 먼저 시각적 참조인지 편집할 이미지인지 묻습니다. 추측하지 마십시오.
- 공개 네트워크 이미지는 사용자가 명시적으로 제공한 합법적인
https://URL만 허용하며, 프로필이 선언한 필드 및 전송 방식에만 넣을 수 있습니다. URL을 다운로드, 탐지, 재저장, 재작성 또는 생성해서는 안 됩니다. - 로컬 이미지 참조 또는 편집은 선택한 프로필의
image_edit멀티파트 작업이 명시적으로 지원해야 하며, 해당 경로, 필드, 수량 및multipart_file전송 방식을 엄격히 사용합니다. 현재 첨부 파일만 이 Images API 요청과 함께 전송합니다. R2에 업로드하거나, 독립 업로드 인터페이스를 호출하거나, 파일 ID를 생성하거나, 첨부 파일 내용을 프롬프트로 다시 작성하거나, 조용히 텍스트-이미지로 다운그레이드해서는 안 됩니다. - 참조 이미지 프롬프트는 "참조"의 의도를 유지합니다. 편집 프롬프트는 "무엇을 수정하고, 무엇을 유지할지"를 명확히 합니다. 마스크, 투명 배경, 선언되지 않은 다중 참조 이미지 및 기타 선언되지 않은 확장은 청구 전에 중단하고 제한 사항을 설명합니다.
비동기 작업 및 전달
- 각 새 요청은 최대 한 번의 POST입니다. POST가 시작되었지만 구문 분석 가능한 결과나 작업 ID가 없는 경우, 결과를 '알 수 없음'으로 제출합니다. 재시도하지 않고, 모델을 변경하지 않으며, 생성되지 않았거나, 청구되지 않았거나, 환불되었다고 주장하지 않습니다. 작업 ID가 없는 경우, 후속 새 요청은 사용자의 명시적인 확인을 받아야 합니다.
- 선언된 최상위 필드 또는 최상위
task_id/id에서만 작업 ID를 가져옵니다. 동일한https://api.puretokensx.com/v1/images/{task_id}만 쿼리하고 성공 후content?index=0..n-1순서로 전달합니다. URL, 상태 텍스트, HTML, SVG는 성공적인 전달이 아닙니다. - 각 폴링 창은 최대 6번의 상태 읽기, 최대 120초입니다. 일반 대기 시간은 3, 6, 12, 24, 30초입니다. 429의 경우 유효한
Retry-After가 현재 예산 내에 있는 경우에만 동일한 작업을 계속합니다. 백그라운드 폴링, 동시 상태 읽기, 자동 재시도는 없습니다. - 호스트가 실제로 원시 이미지 바이트 또는 첨부 파일을 전달하는 경우에만 성공을 보고합니다. 하나씩 전달하며, 미리 가져오지 않고, 반복해서 읽지 않으며, 사용자 미디어를 캐시하지 않습니다. 성공 후 현재 응답을 종료합니다.
실패 영수증
네트워크, 승인, 첨부 파일 전달 또는 원시 바이트 전달 기능으로 인해 POST 전에 호스트가 차단된 경우, failure_phase: validation을 반환하고 Images API가 실행되지 않았음을 명확히 하며 구성 이유를 추측하지 않습니다. 다른 실패는 execution-contract.json 및 일치하는 동작 시나리오에 따라 안전한 영수증을 출력합니다. API가 실제로 반환한 HTTP 상태 및 공개 오류 코드만 보고합니다. 원시 응답, 내부 URL, 스택, 자격 증명, 요청 내용 또는 사용자 미디어를 노출하지 않습니다.