개발에 실제로 영향을 주는 업데이트

어떤 모델을 쓸지 정하는 데 도움이 되는 네 곳이 새로 생겼습니다. 모두 이 플랫폼에서 실제로 실행한 결과로 만들었습니다. 리더보드, 리뷰, 블라인드 대결은 사이트 헤더의 랭킹 아래에, 프롬프트 라이브러리는 스튜디오 아래에 있습니다.

• 리더보드는 모델마다 두 가지 별도 척도로 점수를 매깁니다. Spicy Index(0~100)는 아직 잠정 점수로, 성능만 채점합니다. 출력 품질은 품질 테스트와 블라인드 대결 투표가 충분히 모이면 반영됩니다. Freedom Score(0~100)는 각 모델이 저희 콘텐츠 테스트 단계를 어디까지 확실하게 통과하는지를 측정합니다. 두 점수는 섞이지 않으며, 가격·속도·안정성은 점수에 넣지 않고 측정값 그대로 옆에 보여 줍니다. 영상, 이미지, LLM, 무검열, 가성비, 속도 보드가 있고, 9월 26일 기준 1,672회의 테스트 실행으로 53개 모델의 순위를 매겼습니다. 점수는 매일 다시 계산합니다.
• 리뷰는 지금까지 8편입니다. MiniMax H3, MiniMax H3 Spicy, Seedance 2.5, Seedance 2.5 Spicy, Wan 3.0, Seedream 5.0 Pro, Z-Image Spicy, Grok 4.7. 각각 실제 출력, 테스트 보고서, 쓸 만한 결과 하나의 비용, 분명한 추천을 담았습니다.
• 블라인드 대결에서는 같은 프롬프트로 만든 익명의 이미지 또는 영상 두 개를 봅니다. 남기고 싶은 쪽을 고르면 어떤 모델이 만들었는지 공개됩니다. 로그인한 사용자의 투표로 Bradley–Terry 레이팅(95% 구간, 매시간 갱신)을 정하고, 구간이 겹치는 모델은 같은 순위입니다. 투표가 충분히 모이기 전에는 순위를 매기지 않고 모델을 제공사별로 나열합니다.
• 프롬프트 라이브러리에는 영상·이미지 모델용 프롬프트 176개가 실제로 나온 결과와 함께 있습니다. 모델, 작업, 장면, 카메라 움직임으로 거른 뒤 프롬프트를 복사하거나, 모든 설정이 채워진 상태로 플레이그라운드에서 열 수 있습니다.

평가 방법은 버전별로 공개합니다. 저희는 순위를 매기는 모든 모델에 대한 접근을 판매하므로, 그것이 점수에 섞이지 않게 하는 방법도 같은 페이지에서 설명합니다.

작업 동작에 네 가지 변경이 있습니다. 그중 두 가지는 대응이 필요할 수 있습니다. 같은 요청이 같은 결과를 낸다고 가정하고 있다면 seed를 보내고, 오류 코드로 분기한다면 40310 처리를 추가하세요.

실패한 실행은 먼저 다른 경로에서 다시 시도합니다. 여기 있는 모델 상당수는 두 개 이상의 경로로 제공됩니다. 9월 23일부터는 접수 후 실행이 실패했을 때 같은 모델을 같은 설정으로 제공하는 다른 경로가 있으면, 작업 시간이 남아 있는 한 그 경로에서 실행한 뒤에야 실패를 알립니다. 과금은 받은 결과에 대해 한 번뿐입니다. 저작권 거부처럼 어디서 실행해도 반복될 실패는 재시도하지 않습니다.

거부 메시지가 원인과 해결 방법을 알려 줍니다. 저작권 가능성이나 실존 인물의 얼굴 때문에 모델이 결과를 막으면, 이제 errorMessage가 어느 쪽인지와 무엇을 시도할지 알려 줍니다.

• 영상이 저작권으로 막히는 원인은 대개 자동 생성된 사운드트랙입니다. generate_audio: false로 설정하고, 참조 오디오를 빼고, 실제 곡이나 아티스트 이름을 프롬프트에 넣지 마세요.
• 이미지가 저작권으로 막히는 경우는 대개 프롬프트나 참조 이미지에 유명 캐릭터, 로고, 작품이 들어 있습니다.
• 참조 이미지에 실존 인물의 얼굴을 받지 않는 모델이 있습니다. 이때 메시지가 그 사실을 알리고 다른 모델이나 일러스트 캐릭터를 제안합니다.

errorCode는 그대로 content_rejected이고 요금은 환불되며, 메시지는 다른 오류와 마찬가지로 계정의 API 오류 언어로 표시됩니다.

seed를 빼면 무작위 seed를 씁니다. 9월 24일부터 seed를 받는 모델에서 seed 없이 보낸 요청에는 무작위 seed를 지정하고, 작업의 input으로 돌려줍니다. 같은 요청 두 개가 더 이상 같은 결과를 내지 않습니다. 실행 결과를 비교할 수 있게 하려면 돌려받은 seed를 다시 보내세요. 다만 seed를 고정해도 완전히 같은 결과가 나온다는 보장은 없습니다. 일부 모델은 seed를 무작위로 바꾸지만 input에는 돌려주지 않습니다. 직접 보낸 seed는 항상 그대로 사용합니다.

이메일을 인증하지 않은 계정에는 40310. 이런 계정의 키에는 그동안 일반 403이 돌아갔습니다. 9월 25일부터는 업무 코드 40310과 함께 인증 링크를 열거나 콘솔에서 새 인증 메일을 보내라는 메시지가 돌아갑니다. 주소를 인증하는 즉시 키가 작동합니다.

공식 SDK 다섯 개와 함께 CLI, MCP 서버, Agent Skill, 그리고 키를 들고 있지 않아도 되는 프록시를 공개했습니다. 모두 같은 네 단계를 구현합니다. 견적, 멱등 키를 붙인 생성, 대기, 수거입니다.

• 의존성 트리에 들어가는 것이 거의 없습니다. Python과 Go는 표준 라이브러리만 쓰고, PHP도 별도 라이브러리가 필요 없으며, Java는 Jackson 하나뿐입니다.
• HTTP 호출만이 아니라 비동기 흐름 전체를 다룹니다. 작업 생성 시의 대기 예산, 직접 만든 이미지·영상을 올리는 3단계 업로드, 웹훅 서명 검증까지 들어 있습니다.
• @spicyapi/cli는 터미널에서 카탈로그를 둘러보고, 돈을 쓰기 전에 가격을 뽑아 보고, 완성된 결과물을 내려받습니다. @spicyapi/mcp는 Claude Code, Codex, Cursor를 비롯한 모든 MCP 클라이언트에 같은 기능을 주면서 과금 전에 반드시 확인을 받습니다. Agent Skill은 npx skills add Spicy-API/spicy-skill로 설치하며 코딩 어시스턴트에게 올바른 작업 순서를 가르칩니다.
• @spicyapi/proxy는 키를 서버에 남겨 둡니다. 브라우저·모바일·데스크톱 앱에 박아 넣은 키는 사실상 공개된 키이며, 이 패키지가 그 자리를 대신하는 서버 측 중계 지점입니다.

다섯 개 모두 MIT 라이선스 오픈소스입니다. 각 가이드는 docs.spicyapi.ai에 있습니다.

폴링 루프를 직접 짜지 않아도 되는 방법이 두 가지, 둘 다 사용할 수 있습니다.

작업 생성 시의 대기 예산. createTask에 ?wait=<초>를 붙이면 작업이 종료 상태에 이를 때까지 서버가 연결을 붙잡고 있다가, recordInfo와 같은 형태의 작업 레코드를 돌려줍니다.

• 예산을 다 쓰면: wait를 빼고 호출했을 때와 똑같은 202가 오고, 거기서부터 폴링하면 됩니다.
• 연결이 끊기면: 작업에는 아무 일도 생기지 않습니다. 그대로 실행되고 평소대로 과금됩니다.
• 상한은 60초입니다. 더 큰 값은 거부가 아니라 잘라 맞추고, 형식이 잘못된 값도 거부가 아니라 무시합니다. 최적화용 파라미터의 오타 때문에 성공했을 생성이 실패해서는 안 되기 때문입니다.

몇 초면 끝나는 엔드포인트, 즉 대부분의 이미지 생성과 편집에 쓸 만합니다. 영상 모델은 보통 몇 분씩 걸리므로 그냥 시간 초과가 나고 결국 폴링하게 됩니다.

계정 단위 웹훅 엔드포인트. URL과 받고 싶은 이벤트를 한 번 등록해 두면 해당하는 작업이 모두 그곳으로 전달됩니다. 작업마다 콜백 URL을 넘길 필요가 없어집니다. 계정당 최대 16개이고 각자 서명 시크릿을 가집니다. 수신 측이 410 Gone을 돌려주면 그 엔드포인트는 재시도 없이 즉시 비활성화됩니다. 주인이 접은 주소를 계속 두드려 봐야 누구에게도 득이 되지 않으니까요. 엔드포인트 관리는 지금은 API로만 가능하고, 콘솔에는 아직 해당 화면이 없습니다.

자세히: 작업 · 웹훅

403건의 생성 예시가 호출 가능한 120개 엔드포인트 중 117개를 덮었습니다. 전부 이 플랫폼에서 실제로 돌린 작업이며, 콘셉트 이미지도 모델 카드에서 빌려온 스틸도 아닙니다. 각각에는 세 가지가 붙어 있습니다.

• 완성된 결과물. 자체 CDN에서 원래 화면비 그대로 제공합니다.
• 그 결과를 만든 입력 객체 전체. 프롬프트, 크기, 길이, 모든 파라미터까지 포함해 여러분의 호출에 그대로 복사할 수 있습니다.
• 열 개 인터페이스 언어로 쓴 설명. 왜 그 입력을 골랐는지, 구도가 어떤 화면비를 전제로 쓰였는지, 어떤 파라미터가 일을 하고 있는지, 무엇부터 바꿔 보면 되는지를 짚어 줍니다.

모델 페이지에서는 한눈에 훑을 수 있는 형태로 늘어서고, API에서는 GET /console/v1/catalog/models/{slug}의 examples로 돌아옵니다.

예전에는 모델을 고르려면 파라미터 표를 읽고 결과를 상상하는 수밖에 없었습니다. 이제는 그 엔드포인트가 실제로 무엇을 내놓는지 보고, 확실히 작동하는 입력에서 출발할 수 있습니다.

카탈로그 둘러보기