Citations Public Release and Increased Default Rate Limits

[shubhang98]

We are excited to announce the public availability of citations in the Perplexity API. In addition, we have also increased our default rate limit for the sonar online models to 50 requests/min for all users.

Effective immediately, all API users will see citations returned as part of their requests by default. This is not a breaking change. The return_citations parameter will no longer have any effect.

[ashagraev]

That really sounds exciting! But am I the only one not seeing the citations returned? Also, it seems like they are not mentioned in the docs (https://docs.perplexity.ai/api-reference/chat-completions), so it's hard to tell whether I'm doing something wrong.

curl --request POST \
     --url https://api.perplexity.ai/chat/completions \
     --header 'accept: application/json' \
     --header 'authorization: Bearer ...' \
     --header 'content-type: application/json' \
     --data '{
  "model": "llama-3.1-sonar-small-128k-online",
  "messages": [
    {
      "role": "user",
      "content": "what is retinol?"
    }
  ]
}' | qj -C .
{
  "id": "8d2304b9-66f7-423e-9d9f-f53606b7ed6e",
  "model": "llama-3.1-sonar-small-128k-online",
  "created": 1731061926,
  "usage": {
    "prompt_tokens": 6,
    "completion_tokens": 308,
    "total_tokens": 314
  },
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Retinol is a form of vitamin A, specifically a retinoid, which is derived from vitamin A. It is commonly used in skincare products to address various skin concerns, including aging, acne, and uneven skin tone. Here are the key points about retinol:\n\n- **Origin**: Retinol is a synthetic form of vitamin A, ensuring consistent quality and stability.\n- **Biological Role**: It plays a crucial role in vision, cellular development, maintenance of skin and mucous membranes, immune function, and reproductive development.\n- **Skin Benefits**: Retinol helps neutralize free radicals, promotes cell turnover, prevents collagen breakdown, and stimulates collagen and elastin production. This can reduce the appearance of fine lines, wrinkles, and enlarged pores, as well as improve skin texture and tone.\n- **Usage**: It is typically applied topically in various forms such as serums, gels, creams, and emollients. For best results, it is recommended to start with a gradual introduction to allow the skin to adjust to its effects.\n- **Side Effects**: Common side effects include dry, irritated, or itchy skin, redness, and peeling. It can also make the skin more sensitive to UV radiation, so using sunscreen is recommended.\n\nRetinol is widely recognized as a key ingredient in anti-aging skincare products due to its effectiveness in addressing various signs of skin aging and improving overall skin health."
      },
      "delta": {
        "role": "assistant",
        "content": ""
      }
    }
  ]
}

Am I missing something trivial here or is it simply needs some time to become available?

[saendu]

same here

[aarashy]

This is fixed now!

[saendu]

confirmed

[ashagraev]

Works perfectly :) The same example now works for me, the response:

{
  "id": "913a553b-7715-46dc-a2d7-52ae1d6918fd",
  "model": "llama-3.1-sonar-small-128k-online",
  "created": 1731094372,
  "usage": {
    "prompt_tokens": 6,
    "completion_tokens": 462,
    "total_tokens": 468
  },
  "citations": [
    "https://inside-our-products.loreal.com/ingredients/retinol",
    "https://en.wikipedia.org/wiki/Retinol",
    "https://www.dermalogica.com/blogs/living-skin/what-is-retinol",
    "https://www.healthline.com/health/beauty-skin-care/how-does-retinol-work",
    "https://www.medicalnewstoday.com/articles/retinols"
  ],
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "finish_reason": "stop",
      "message": {
        "role": "assistant",
        "content": "Retinol is a form of vitamin A, specifically a retinoid, which is used in skincare products to address various skin concerns. Here are the key points about retinol:\n\n1. **Definition**: Retinol is a derivative of vitamin A, one of the three forms of vitamin A along with retinal and retinoic acid[1][2][3].\n\n2. **Biological Role**: It plays a crucial role in maintaining skin health, vision, and cellular development. It helps in the regeneration of rhodopsin, which is essential for night vision, and is involved in the maintenance of the skin's barrier function[2][3].\n\n3. **Skin Care Benefits**: Retinol is widely used in skincare products to reduce the signs of aging, such as fine lines, wrinkles, and age spots. It promotes cell turnover, improves skin texture, and reduces the appearance of pores[1][3][4].\n\n4. **Forms and Concentrations**: Retinol is available over-the-counter (OTC) in various forms, including liquid serums, gels, creams, and emollients. The concentration of retinol in OTC products typically ranges up to 2%, while prescription-strength retinoids can be more potent[5].\n\n5. **Mechanism of Action**: Once applied topically, retinol penetrates the stratum corneum and slightly into the dermis. It is then converted into retinoic acid, which promotes collagen production, prevents collagen breakdown, and stimulates cell turnover, leading to smoother and more even-toned skin[4][5].\n\n6. **Side Effects**: While generally well-tolerated, retinol can cause mild irritations, dryness, redness, itchiness, and peeling skin, especially during the initial stages of use. It is recommended to start with a low concentration and gradually increase as the skin builds up tolerance[1][4][5].\n\n7. **Usage Precautions**: To minimize irritation, it is advised to use retinol products at night, avoid direct sun exposure, and apply sunscreen during the day. A gradual introduction to retinol products is also recommended to allow the skin to adjust to its effects[1][3][4]."
      },
      "delta": {
        "role": "assistant",
        "content": ""
      }
    }
  ]
}

[jsandlerus]

are citations limited to text or do they also include images / videos urls?

[Mathias-RS]

can we have more than 5 citations?