# Fish Audio S1

> Fish Audio S1 (레거시) TTS. 소괄호 고정 감정 태그((happy), (sad), (whispering) 등)와 Voice Library 음성. S2 계열과 동일 요율이며 기존 S1 프롬프트 호환용.

- **Provider**: fishaudio
- **Model ID**: fishaudio/s1
- **Category**: tts_voice
- **Credits**: 105 per request
- **Pricing Type**: token_based

## API Endpoint

Base URL: https://api.core.today/v1

### Create Prediction
POST /predictions

### Get Status
GET /predictions/{job_id}

### Cancel
DELETE /predictions/{job_id}

## Authentication

Header: `X-API-Key: YOUR_API_KEY`

## Input Parameters

- `format` (string, optional): 출력 오디오 포맷 (Default: `mp3`; Options: `mp3`, `wav`, `opus`)
- `latency` (string, optional): balanced = 지연 우선(기본), normal = 안정성 우선. 스트리밍이 아닌 일괄 생성엔 normal 이 무난하다. (Default: `balanced`; Options: `balanced`, `normal`)
- `volume` (number, optional): 볼륨 조정 (dB, 0 = 기본) (Default: `0`; Range: min: -20, max: 20)
- `speed` (number, optional): 말하기 속도 배율 (1.0 = 기본) (Default: `1`; Range: min: 0.5, max: 2)
- `temperature` (number, optional): 샘플링 온도. 낮을수록 일관된 억양, 높을수록 표현이 다양해진다. (Default: `0.7`; Range: min: 0.1, max: 1)
- `normalize` (boolean, optional): 숫자·날짜·단위를 읽기 형태로 정규화 (예 "2026" → 이천이십육) (Default: `True`)
- `top_p` (number, optional): nucleus 샘플링 확률 질량 (Default: `0.7`; Range: min: 0.1, max: 1)
- `chunk_length` (integer, optional): 내부 청크 길이 (100–300). 긴 문장의 호흡 단위에 영향. (Default: `200`; Range: min: 100, max: 300)
- `reference_id` (string, optional): 음성 ID (Fish Audio Voice Library 의 32자리 hex). 큐레이션한 37종(Fish 공식 한국어 15, 한국어 커뮤니티 18, 로봇·캐릭터 4)은 이 모델의 Core.Today Docs 페이지(console.core.today/docs/models/fishaudio/…) 하단 음성 갤러리에서 미리 듣고 복사할 수 있다. 다른 공개/클론 음성 ID 도 그대로 쓸 수 있으며, 그 음성의 사용 권리는 호출자 책임이다. 생략 시 Fish 기본 음성. (Default: `2f06c7a428e9431fadd60af4dfe91763`)
- `mp3_bitrate` (integer, optional): MP3 비트레이트 (kbps). format=mp3 일 때만 적용. (Default: `128`; Options: `64`, `128`, `192`)
- `text` (string, **required**): 변환할 텍스트 (UTF-8). 과금은 UTF-8 바이트 기준 — 한글 1자 = 3바이트. 감정 태그는 S1 방식의 소괄호 고정 태그 — 예 `(happy) 반갑습니다!`, `(sad)(whispering) 보고 싶을 거예요`.

## Example Request

```json
{
  "model": "fishaudio/s1",
  "input": {
    "format": "mp3",
    "text": "\uc548\ub155\ud558\uc138\uc694, \ucf54\uc5b4\ub2f7\ud22c\ub370\uc774\uc785\ub2c8\ub2e4. \ud558\ub098\uc758 API \ud0a4\ub85c \uc774\ubbf8\uc9c0, \uc601\uc0c1, \uc74c\uc131 \uc0dd\uc131 \ubaa8\ub378\uc744 \ubaa8\ub450 \uc5f0\uacb0\ud574 \ubcf4\uc138\uc694.",
    "reference_id": "2f06c7a428e9431fadd60af4dfe91763",
    "mp3_bitrate": 128
  }
}
```

## Response Format

```json
{
  "job_id": "abc123",
  "status": "pending",
  "provider": "replicate",
  "model": "black-forest-labs/flux-schnell",
  "created_at": "2026-01-01T00:00:00Z",
  "result": null,
  "error": null
}
```

Status values: `pending`, `processing`, `completed`, `failed`, `cancelled`

## Usage Flow

1. POST /predictions with model and input → receive job_id
2. Poll GET /predictions/{job_id} until status is `completed` or `failed`
3. Result contains output URL(s) or data

## Output Type

url

## Tags

text-to-speech, tts, fish-audio, korean, multilingual, voice-cloning, emotion-control

## Documentation

https://docs.fish.audio/features/text-to-speech


## Token Pricing

- Input: 0.034875 credits/token
- Output: 0.034875 credits/token