GPT Image 2.5 is live — OpenAI's newest image model, targeted edits that leave the rest of the frame alone
모든 가이드

· reAPI Team

Together AI model not available: 카탈로그와 API 접근

정확한 모델 ID, serverless 지원, 전용 엔드포인트 준비 상태, 프로젝트 범위 및 API 응답을 확인하여 Together AI model not available 오류를 해결합니다.

Together AI model not available: 카탈로그와 API 접근

Evo 프로젝트의 과거 이슈에서 Together 응답은 model_not_available을 보고하며 요청이 serverless가 아닌 모델을 사용하려 한다고 설명했습니다. 제안된 다음 단계는 전용 엔드포인트였습니다.[1] 모델은 존재했습니다. 해당 응답에서 설명한 문제는 시도한 호출 방식이었습니다.

이 보고는 현재 장애나 특정 모델의 오늘 가용성을 보여 주는 증거가 아닙니다. 전체 메시지가 중요한 이유를 보여 줍니다. Together는 serverless 추론과 전용 추론에 서로 다른 모델 집합을 문서화하며, 전용 모델도 사용 가능한 배포가 필요합니다.[2][3] 사용할 것으로 예상한 모델 카드가 아니라 애플리케이션이 실제로 보낸 요청에서 시작합니다.

모델 값, 호스트 및 경로 복사하기

실패한 요청에서 정확한 model 문자열을 가져옵니다. 네임스페이스, 버전 및 변형 접미사를 유지합니다. 그 옆에 최종적으로 확인된 API 호스트와 요청 경로, HTTP 상태 및 전체 오류 본문을 기록합니다. 이 자료를 공유하기 전에 인증 비밀 정보를 제거합니다.

그런 다음 모델 값의 출처를 확인합니다. 현재 serverless 목록, 오래된 SDK 예제 및 전용 엔드포인트 화면은 서로 다른 종류의 식별자를 제공할 수 있습니다. 익숙한 표시 이름이라고 해서 서로 바꿔 쓸 수 있는 것은 아닙니다.

Together의 현재 전용 워크플로에서는 추론 요청에 project_slug/endpoint_name 형식의 엔드포인트 문자열을 사용합니다. 카탈로그 모델 ID는 배포하도록 선택한 모델을 식별하고, 엔드포인트 문자열은 요청을 처리하는 리소스를 식별합니다.[3] 따라서 설정 메모에는 다음 두 가지 서로 다른 값이 포함될 수 있습니다.

Model selected for deployment: <catalog-model-id>
Model value used for inference: <project-slug>/<endpoint-name>

이는 차이를 보여 주는 자리표시자이며 호출할 수 있는 엔드포인트가 아닙니다. 실제로 사용하려는 모델과 배포에서 값을 가져와 채웁니다. 두 번째 값이 필요한 필드에 첫 번째 값을 복사하는 것은, 둘 다 같은 모델 계열을 가리킨다고 해서 올바른 설정이 되지 않습니다.

작업도 확인합니다. Together의 카탈로그는 채팅, 이미지, 비전, 동영상, 오디오 및 기타 작업을 포함하며 각각에 대한 엔드포인트 안내를 제공합니다.[2] 이미지 모델이 목록에 있다고 해서 채팅 완성 요청을 처리할 수 있다는 뜻은 아닙니다. 자격 증명을 바꾸거나 크레딧을 구매하면 이용할 수 있다고 가정하기 전에 작업을 확인합니다.

serverless에는 serverless 목록 사용하기

애플리케이션이 공유 serverless 추론을 호출한다면 전체 ID를 Together의 현재 serverless 모델 목록과 비교합니다. 더 넓은 카탈로그와 전용 모델 목록은 서로 다른 질문에 답합니다.[2] 이는 “어떤 모델을 사용할 수 있나요?”라는 질문의 답이기도 합니다. 어떤 작업과 서비스 제공 방식에서 사용할 수 있는지를 조회에 포함해야 합니다.

디버깅 메모에 ID의 출처를 남깁니다. 다른 경로를 위해 작성된 튜토리얼에서 가져왔다면 추측으로 모델 이름을 편집하기 전에 해당 경로의 문서를 확인합니다. 오래된 예제에서 가져왔다면 정확히 그 변형이 여전히 제공되는지 확인합니다. 비슷한 이름은 다른 모델을 식별할 수 있으며, 대체 모델 호출에 성공해도 원래 실패를 설명하지는 못합니다.

문서화된 경로가 지원 종료되었다면 문제는 설정 진단에서 마이그레이션으로 바뀐 것입니다. Together AI 지원 종료 가이드로 후속 모델과 기한을 평가합니다. 지원 종료된 ID를 반복해서 사용하거나 키를 교체해도 제거된 경로는 복구되지 않습니다.

정확한 ID가 올바른 현재 목록에 있다면 그 증거를 보존하고 호출자의 계정과 클라이언트 설정으로 진행합니다. 이제 질문은 제공업체가 그 모델을 아예 보유하고 있는지보다 좁아졌습니다.

전용 추론에서는 자신이 소유한 배포 살펴보기

Together의 전용 워크플로는 엔드포인트를 만들고 배포를 연결하며 라우팅을 설정합니다. 배포가 준비된 후 추론을 사용할 수 있습니다.[3] 모델 배포를 지원한다고 해서 프로젝트에 해당 모델의 준비된 복사본이 이미 있다는 뜻은 아닙니다.

의도한 프로젝트에서 의도한 엔드포인트를 찾습니다. 배포 상태와 표시된 정확한 추론 문자열을 살펴봅니다. 애플리케이션이 원래 카탈로그 ID를 serverless 또는 게이트웨이 경로에 계속 보내는 대신 해당 엔드포인트를 호출하는지 확인합니다.

이전에 작동하던 설정이 깨진 뒤에는 프로젝트 이름 변경이 특히 구체적인 확인 사항입니다. Together 문서는 프로젝트 slug를 변경하면 slug로 한정된 리소스 참조가 즉시 바뀌며 이전 slug는 리디렉션되지 않는다고 설명합니다.[4] 이 경우 모델과 배포는 여전히 존재할 수 있지만 저장된 엔드포인트 문자열은 오래된 이름을 가리킬 수 있습니다.

다른 배포를 만들기 전에 이미 워크로드를 처리하고 있어야 할 배포를 살펴봅니다. 전용 추론은 실행 중인 하드웨어에 분 단위로 요금을 부과하므로, 추가 엔드포인트를 프로비저닝하는 것은 비용을 수반하는 용량 결정입니다.[3] 엔드포인트 이름 불일치로 실패를 설명할 수 있을 때 이는 적절한 진단 지름길이 아닙니다.

가격도 경로에 따라 달라집니다. Together의 serverless 채팅 목록은 토큰 요율을 사용하고, 다른 모달리티는 문서화된 단위를 사용하며, 전용 추론은 해당 하드웨어 과금 방식을 사용합니다.[2][3] 토큰 견적과 배포 비용을 비교하기 전에 요청이 어떤 서비스에 도달하려 하는지 확인합니다.

브라우저의 프로젝트가 워커의 프로젝트와 다를 수 있음

Together는 리소스와 API 키의 범위를 프로젝트로 제한합니다. 한 프로젝트의 리소스에 접근할 수 있다고 해서 다른 프로젝트의 엔드포인트에 자동으로 접근할 수 있는 것은 아닙니다.[4] 따라서 대시보드에 보이는 프로젝트는 증거의 일부일 뿐입니다.

브라우저에서 Project B의 준비된 엔드포인트를 살펴보는 동안 워커에는 여전히 Project A의 키가 설정되어 있는 가상의 상황을 생각해 봅니다. 대시보드 화면은 정확할 수 있지만 워커는 여전히 잘못된 접근 컨텍스트를 사용하고 있을 수 있습니다. 비밀 정보를 로그에 붙여 넣는 대신 안전하게 확인할 수 있는 자격 증명 식별자와 프로세스의 실제 설정을 확인합니다.

클라이언트나 배포 도구가 프로젝트를 선택하는 여러 방법을 제공한다면 설정 우선순위를 따라 확인합니다. 명시적 설정, 환경 값 및 인증된 관리 컨텍스트는 의도한 리소스와 일치해야 합니다.[3][4] 실패하는 워커도 이 확인에 포함합니다. 노트북에서 호출이 성공했다고 해서 별도 프로세스가 무엇을 로드했는지는 알 수 없습니다.

대신 reAPI나 다른 호스트를 사용한다면 해당 대상의 모델 식별자와 자격 증명 형식을 사용합니다. reAPI 인증 참조는 reAPI 자체 자격 증명을 설명하며, Together 프로젝트를 활성화하거나 Together 키를 다른 서비스에서 사용할 수 있게 만들 수는 없습니다.[5] 설정을 비교할 때 호스트와 자격 증명 변경을 함께 확인합니다.

SDK가 Together를 직접 호출하는지 확인하기

AI SDK의 Together 통합 문서는 AI Gateway와 직접 사용하는 @ai-sdk/togetherai 제공업체라는 두 경로를 설명합니다. 문서화된 SDK 동작에서 단독 모델 문자열은 기본적으로 Gateway를 사용하며, 직접 제공업체는 Together용으로 설정된 모델 인스턴스를 만듭니다.[6]

이 설정 전용 예제는 Gateway와 직접 제공업체를 비교합니다. 자리표시자 ID는 각 카탈로그에서 지원하는 ID로 바꿔야 하며, 추론 요청은 보내지 않습니다. 완전한 전용 엔드포인트 설정은 아닙니다. 해당 워크플로에는 문서화된 추론 호스트 또는 기본 URL과 프로젝트/엔드포인트 문자열도 필요합니다.

import { togetherai } from '@ai-sdk/togetherai';

const gatewayOptions = {
  model: 'MODEL_ID_IN_GATEWAY_CATALOG',
};

const directOptions = {
  model: togetherai('MODEL_ID_IN_TOGETHER_CATALOG'),
};

문서화된 Gateway 설정은 AI_GATEWAY_API_KEY를 사용하며, 직접 제공업체는 기본적으로 TOGETHER_API_KEY를 사용합니다. 사용 가능한 모델과 기능은 서로 다를 수 있습니다.[6] 환경의 한 부분에 Together 자격 증명을 제공한 것만으로는 단독 문자열 요청이 이를 사용한다는 증거가 되지 않습니다.

Gateway의 제공업체 순서 옵션도 정확히 읽어 볼 만한 세부 사항입니다. 문서화된 순서는 선호도를 나타내며 폴백을 허용합니다. 모든 요청을 지정된 제공업체로 제한하지는 않습니다.[6] 따라서 Gateway 요청의 성공만으로는 직접 사용하는 Together 프로젝트가 해당 모델을 제공할 수 있음을 증명하지 못합니다.

설치된 SDK 버전과 최종 연결 설정을 문서와 대조합니다. 클라이언트가 코드에서 모델 이름 옆에 보이지 않는 기본 URL이나 다른 기본값을 적용할 수 있습니다. 패키지를 교체하거나 관련 없는 애플리케이션 로직을 편집하기 전에 구성된 요청을 비교합니다.

의도한 호스트, 계정 및 모델을 고정한 채 진단 요청을 문서화된 작업과 필수 필드로 줄입니다. 그런 다음 애플리케이션 요청과 비교합니다. 최소 형식은 작동하지만 전체 형식은 실패한다면 차이가 계속 드러나도록 선택 기능을 하나씩 복원합니다. 둘 다 같은 가용성 메시지와 함께 실패한다면 프롬프트 변경으로 경로 불일치를 설명할 가능성은 낮습니다. 이 비교를 위해 실행하기로 선택한 추론은 요금이 발생할 수 있습니다. 해결되지 않은 요청을 자동 재시도 루프에 넣는 대신 일반적인 승인된 테스트 예산 안에서 실행합니다.

이미지, 임베딩 또는 리랭킹 작업이라면 SDK 문서에 있는 해당 제공업체 팩토리와 작업을 사용하는지도 확인합니다.[6] 모델 문자열의 철자가 카탈로그와 일치해도 잘못된 작업으로 전달하면 여전히 잘못된 요청입니다.

남은 오류에 따라 다음 변경 결정하기

경로와 호출자가 일치하면 모든 거부를 모델 지원 부족으로 계속 해석하지 말고 실제 오류를 읽습니다. Together 참조 문서는 인증 실패, 자금에 따른 이용 중단, 접근 제한, 잘못된 URL 또는 모델 이름, 제한 및 일시적인 서비스 이용 불가를 구분합니다.[7]

401은 인증 문제를 가리킵니다. 402는 지출 중단 조건이나 양수 크레딧 요구 사항을 나타낼 수 있습니다. 403은 명시된 접근 사유를 확인해야 합니다. 429는 작업 컨텍스트가 필요합니다. serverless 제한과 전용 관리 요청의 GPU 할당량 초과는 서로 다른 경우입니다. Evo의 과거 응답은 model_not_available이 항상 404와 함께 도착한다고 하드코딩해서는 안 되는 이유도 보여 줍니다.[7][1]

카탈로그 목록을 무료 호스팅 접근의 증거로 사용하지 않습니다. 2026년 11월 16일에 검토한 Together 크레딧 정책은 무료 체험이 없고, 최초 구매로 최소 US$15가 필요하며, 무료 크레딧은 그 최소 조건을 충족하지 못한다고 명시합니다. 선불 접근을 계속하려면 양수 잔액이 필요하며, 유효한 Scale 및 Enterprise 계약에는 자체 조건이 있습니다.[8] 이러한 조건은 잘못된 모델 ID나 경로와는 별개입니다. 다시 결제해도 어느 문자열도 수정되지 않습니다.

설정과 문서화된 가용성이 여전히 응답과 모순된다면 그 정확한 모순을 지원팀에 보냅니다. 정확한 ID 또는 엔드포인트, 호스트와 경로, 의도한 프로젝트, 타임스탬프, SDK 버전, HTTP 상태 및 민감 정보를 제거한 전체 오류를 포함합니다. 반환된 요청 ID가 있다면 함께 제공합니다. 확인한 현재 목록이나 준비된 배포를 명시합니다. 그러면 지원팀은 모델 카드 스크린샷에서 추론하는 대신 실패한 요청을 조사할 수 있습니다.

참고 자료

  1. Evo 프로젝트, GitHub 이슈 95, api.together.ai에서 모델을 사용할 수 없음, 응답 포함. 과거 보고를 2026년 11월 15일에 검토했습니다.
  2. Together AI, 사용 가능한 모델: serverless 카탈로그, 작업 유형 및 전용 모델 구분. 2026년 11월 15일 검토했습니다.
  3. Together AI, 전용 모델 추론 개요: 프로젝트 선택, 준비 상태, 엔드포인트 문자열 및 하드웨어 과금. 2026년 11월 15일 검토했습니다.
  4. Together AI, 프로젝트: 리소스 경계, 프로젝트 API 키 및 slug 변경. 2026년 11월 15일 검토했습니다.
  5. reAPI, 인증. 2026년 11월 15일 검토했습니다. 외부 출처 URL과 전체 스냅샷은 연구 아카이브에 보존되어 있습니다.
  6. AI SDK, Together.ai 제공업체: Gateway 및 직접 제공업체 설정. 2026년 11월 15일 검토했습니다.
  7. Together AI, 오류 코드. 2026년 11월 15일 검토했습니다.
  8. Together AI, 크레딧: 무료 체험 정책, 최초 구매 요구 사항 및 계약 예외. 2026년 11월 16일 검토했습니다.
모든 가이드